@akredit/acik-mcp 0.4.0 → 0.5.0

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

@@ -4,14 +4,65 @@
 // adrese girer (SSRF yok). Her istekte zaman aşımı ve yanıt boyutu sınırı vardır, yanıt zod ile doğrulanır.
 //
 // Uydurma yok: künye yalnız katalog yanıtındaki alanlardan kurulur ve kaynak_bicimle biçimiyle yazılır. Başlık
-// ve yazarla aramada eşleşme deterministik bir benzerlik denetiminden geçmezse sonuç "doğrulanamadı"dır; istem o
-// eserin asla önerilmemesini söyler.
+// ve yazarla aramada eşleşme deterministik bir denetimden (başlık sözcükleri, tam soyad belirteci, kayıt türü,
+// verilmişse yıl) geçmezse sonuç "bulunamadi"dır.
+//
+// Ayrım (dış inceleme 2026-11-05): "katalogda bulundu" yalnız eserin katalogda var olduğunu söyler; "ders kaynağı
+// olarak uygun" kararı hocanındır. Türkçe kitapların çoğu bu kataloglarda yoktur: bulunamayan eser uydurma sayılmaz
+// ama doğrulanmış da sayılmaz; yalnız hocanın verdiği bilgiyle "hoca_beyani" etiketiyle yazılabilir.
+//
+// Kötüye kullanım sınırı: çağrı başına en çok 5 kaynak, süreç genelinde en çok 4 eşzamanlı dış istek, yanıt akışla
+// okunur ve sınırda kesilir. Adres başına ayrı kota HTTP katmanındadır (http.ts).
+//
+// İmza: bulunan her kayıt, sürecin gizli anahtarıyla künye+bağlantı üzerinden imzalanır. Bologna araçları kaynağı
+// "doğrulanmış" saymak için bu imzayı arar; asistan imzayı kendisi üretemez.
+import { createHmac, randomBytes, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
 import { kunyeBicimle } from "./kaynak.js";
 import { AracHatasi, arac, KOD_KAYNAGI } from "./temel.js";
 export const IZINLI_HOSTLAR = ["api.crossref.org", "openlibrary.org", "www.googleapis.com"];
 export const ZAMAN_ASIMI_MS = 8000;
 export const EN_BUYUK_YANIT = 1_000_000;
+/** Çağrı başına en çok kaynak. */
+export const EN_COK_KAYNAK = 5;
+/** Süreç genelinde aynı anda en çok dış istek. */
+export const ESZAMANLI_DIS_ISTEK = 4;
+// ---------------------------------------------------------------- Eşzamanlılık sınırı (semafor)
+let aktifIstek = 0;
+const bekleyenler = [];
+/** Süreç genelindeki dış istek semaforu. Sınır doluysa sıra bekler. */
+export async function sinirli(is) {
+    if (aktifIstek >= ESZAMANLI_DIS_ISTEK)
+        await new Promise((coz) => bekleyenler.push(coz));
+    aktifIstek += 1;
+    try {
+        return await is();
+    }
+    finally {
+        aktifIstek -= 1;
+        bekleyenler.shift()?.();
+    }
+}
+// ---------------------------------------------------------------- İmza
+// Anahtar ilk kullanımda üretilir: modül tarayıcı araçlarına da (/deneyin) girer ve orada imza hiç kullanılmaz.
+let imzaAnahtari;
+function anahtar() {
+    if (!imzaAnahtari) {
+        const ortam = typeof process !== "undefined" ? process.env.AKREDIT_MCP_IMZA_ANAHTARI : undefined;
+        imzaAnahtari = ortam && ortam.length >= 16 ? Buffer.from(ortam) : randomBytes(32);
+    }
+    return imzaAnahtari;
+}
+/** Katalog kaydının imzası: künye ve bağlantı üzerinden HMAC-SHA256 (ilk 32 onaltılık hane). */
+export function kaynakImzasi(kunye, baglanti) {
+    return createHmac("sha256", anahtar()).update(`${kunye}\n${baglanti}`).digest("hex").slice(0, 32);
+}
+/** İmza bu sürecin kaynak_dogrula çıktısına mı ait? */
+export function kaynakImzasiDogru(kunye, baglanti, imza) {
+    const beklenen = Buffer.from(kaynakImzasi(kunye, baglanti));
+    const verilen = Buffer.from(String(imza));
+    return beklenen.length === verilen.length && timingSafeEqual(beklenen, verilen);
+}
 const DOI_DESENI = /^10\.\d{4,9}\/[^\s]{1,200}$/u;
 /** "https://doi.org/10.x/y", "doi:10.x/y" ya da "10.x/y" → "10.x/y". Geçersizse null. */
 export function doiTemizle(d) {
@@ -47,22 +98,33 @@ export function sadele(s) {
         .split(/\s+/u)
         .filter((x) => x.length > 1);
 }
-/** 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 function baslikEslesir(sorgu, bulunan) {
-    const a = sadele(sorgu);
+    const a = [...new Set(sadele(sorgu))];
     const b = new Set(sadele(bulunan));
     if (!a.length || !b.size)
         return false;
     const ortak = a.filter((x) => b.has(x)).length;
+    if (a.length <= 2)
+        return ortak === a.length && b.size === a.length;
     return ortak / a.length >= 0.8 && ortak / b.size >= 0.6;
 }
-/** 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 function yazarEslesir(sorgu, yazarlar) {
     const soyad = sorgu.includes(",") ? (sorgu.split(",")[0] ?? "") : (sorgu.trim().split(/\s+/u).at(-1) ?? "");
-    const s = sadele(soyad).join(" ");
-    if (!s)
+    const s = sadele(soyad);
+    if (!s.length)
         return false;
-    return yazarlar.some((y) => sadele(y).join(" ").includes(s));
+    return yazarlar.some((y) => {
+        const b = new Set(sadele(y));
+        return s.every((x) => b.has(x));
+    });
 }
 // ---------------------------------------------------------------- Güvenli istek
 async function getir(f, adres) {
@@ -70,31 +132,58 @@ async function getir(f, adres) {
         throw new Error("İzinsiz host");
     if (adres.hostname === "www.googleapis.com" && !adres.pathname.startsWith("/books/"))
         throw new Error("İzinsiz yol");
-    let y;
-    try {
-        y = await f(adres.toString(), {
-            signal: AbortSignal.timeout(ZAMAN_ASIMI_MS),
-            redirect: "error",
-            headers: { accept: "application/json", "user-agent": "akredit-acik-mcp (https://akredit.org)" },
-        });
-    }
-    catch {
-        return null;
-    }
-    if (!y.ok)
-        return null;
-    const uzunluk = Number(y.headers.get("content-length") ?? "0");
-    if (uzunluk > EN_BUYUK_YANIT)
-        return null;
-    const metin = await y.text();
-    if (metin.length > EN_BUYUK_YANIT)
-        return null;
+    return sinirli(async () => {
+        let y;
+        try {
+            y = await f(adres.toString(), {
+                signal: AbortSignal.timeout(ZAMAN_ASIMI_MS),
+                redirect: "error",
+                headers: { accept: "application/json", "user-agent": "akredit-acik-mcp (https://akredit.org)" },
+            });
+        }
+        catch {
+            return null;
+        }
+        if (!y.ok)
+            return null;
+        const uzunluk = Number(y.headers.get("content-length") ?? "0");
+        if (uzunluk > EN_BUYUK_YANIT)
+            return null;
+        const metin = await sinirliMetin(y, EN_BUYUK_YANIT);
+        if (metin === null)
+            return null;
+        try {
+            return JSON.parse(metin);
+        }
+        catch {
+            return null;
+        }
+    });
+}
+/** Yanıt gövdesini bayt sayarak okur; sınır aşılırsa akışı iptal edip null döner. */
+export async function sinirliMetin(y, enBuyuk) {
+    if (!y.body)
+        return "";
+    const okuyucu = y.body.getReader();
+    const parcalar = [];
+    let toplam = 0;
     try {
-        return JSON.parse(metin);
+        for (;;) {
+            const { done, value } = await okuyucu.read();
+            if (done)
+                break;
+            toplam += value.byteLength;
+            if (toplam > enBuyuk) {
+                await okuyucu.cancel().catch(() => { });
+                return null;
+            }
+            parcalar.push(value);
+        }
     }
     catch {
         return null;
     }
+    return Buffer.concat(parcalar).toString("utf8");
 }
 // ---------------------------------------------------------------- Katalog yanıtları (zod)
 const CrossrefEser = z.object({
@@ -134,24 +223,39 @@ const GoogleCilt = z.object({
     }),
 });
 const GoogleYanit = z.object({ totalItems: z.number().optional(), items: z.array(GoogleCilt).optional() });
+const HOCA_BEYANI = "Katalogda bulunamadı. Hoca bu eseri kendisi kullanıyorsa künyesini hocanın verdiği bilgiyle 'hoca_beyani' etiketiyle yazın; asistan künye alanı uydurmaz.";
+const bulunamadi = (neden) => ({ durum: "bulunamadi", neden, hocaBeyani: HOCA_BEYANI });
 const yilAl = (s) => {
     const m = s?.match(/\b(1[4-9]\d{2}|20\d{2}|2100)\b/u);
     return m ? Number(m[1]) : undefined;
 };
-const kur = (k, baglanti, katalog) => {
+const kur = (k, baglanti, katalog, kayitTuru = k.tur === "makale" ? "makale" : k.tur === "kitap_bolumu" ? "kitap_bolumu" : "kitap") => {
     const g = { ...k, kurumYazar: false };
     const { kunye, eksikler } = kunyeBicimle(g);
     return {
-        durum: "dogrulandi",
+        durum: "katalogda_bulundu",
         kunye,
         eksikler,
         baglanti,
         katalog,
+        kayitTuru,
         baslik: k.baslik,
         yazarlar: k.yazarlar,
         ...(k.yil !== undefined ? { yil: k.yil } : {}),
+        kimlik_eslesmesi: { yontem: "baslik_yazar", denetlenen: [] },
+        bibliyografik_tamlik: eksikler.length ? "eksik" : "tam",
+        ders_kaynagi_uygunlugu: "hoca karar verir",
+        imza: kaynakImzasi(kunye, baglanti),
     };
 };
+const CROSSREF_KITAP = new Set(["book", "monograph", "edited-book", "reference-book", "book-set", "book-series"]);
+const crossrefTuru = (t) => t === "journal-article"
+    ? "makale"
+    : t === "book-chapter" || t === "book-section" || t === "book-part"
+        ? "kitap_bolumu"
+        : t && CROSSREF_KITAP.has(t)
+            ? "kitap"
+            : "diger";
 function crossrefKunye(e) {
     const baslik = e.title?.[0]?.trim();
     if (!baslik)
@@ -161,7 +265,8 @@ function crossrefKunye(e) {
         .filter(Boolean);
     const yil = e.issued?.["date-parts"]?.[0]?.[0] ?? undefined;
     const kap = e["container-title"]?.[0];
-    const tur = e.type === "journal-article" ? "makale" : e.type === "book-chapter" ? "kitap_bolumu" : "kitap";
+    const kayit = crossrefTuru(e.type);
+    const tur = kayit === "makale" ? "makale" : kayit === "kitap_bolumu" ? "kitap_bolumu" : "kitap";
     const doi = e.DOI;
     return kur({
         tur,
@@ -180,7 +285,7 @@ function crossrefKunye(e) {
         ...(e.issue ? { sayi: e.issue } : {}),
         ...(e.page ? { sayfalar: e.page } : {}),
         doi,
-    }, `https://doi.org/${doi}`, "Crossref");
+    }, `https://doi.org/${doi}`, "Crossref", kayit);
 }
 function googleKunye(c) {
     const v = c.volumeInfo;
@@ -197,10 +302,41 @@ function googleKunye(c) {
 const CROSSREF = "https://api.crossref.org/works";
 const OPENLIBRARY = "https://openlibrary.org/api/books";
 const GOOGLE = "https://www.googleapis.com/books/v1/volumes";
+const KAYIT_ADI = {
+    kitap: "kitap",
+    makale: "dergi makalesi",
+    kitap_bolumu: "kitap bölümü",
+    diger: "başka türde bir kayıt (bildiri, rapor...)",
+};
+/** Aranan tür ve yıl verildiyse kayıtla uyuşuyor mu; uyuşmuyorsa nedeni. */
+function ekDenetim(k, s) {
+    if (s.tur && s.tur !== "herhangi" && k.kayitTuru !== s.tur)
+        return `Katalogdaki kayıt ${KAYIT_ADI[k.kayitTuru]}; aranan ${KAYIT_ADI[s.tur]}. Aynı eser sayılmadı.`;
+    if (s.yil !== undefined) {
+        const y = typeof k.yil === "number" ? k.yil : yilAl(String(k.yil ?? ""));
+        if (y === undefined)
+            return "Katalog kaydında yıl yok; verilen yılla karşılaştırılamadı.";
+        if (y !== s.yil)
+            return `Katalogdaki yıl ${y}, verilen yıl ${s.yil}. Aynı baskı sayılmadı.`;
+    }
+    return null;
+}
+function sonla(k, yontem, s, bulunamadiNedeni) {
+    if (!k)
+        return bulunamadi(bulunamadiNedeni);
+    const sorun = ekDenetim(k, s);
+    if (sorun)
+        return bulunamadi(sorun);
+    const denetlenen = [
+        yontem === "doi" ? "DOI" : yontem === "isbn" ? "ISBN (sağlama basamağı geçerli)" : "başlık sözcükleri, tam soyad",
+        ...(s.tur && s.tur !== "herhangi" ? ["kayıt türü"] : []),
+        ...(s.yil !== undefined ? ["yıl"] : []),
+    ];
+    return { ...k, kimlik_eslesmesi: { yontem, denetlenen } };
+}
 async function doiIle(f, doi) {
     const y = CrossrefTek.safeParse(await getir(f, new URL(`${CROSSREF}/${encodeURIComponent(doi)}`)));
-    const k = y.success ? crossrefKunye(y.data.message) : null;
-    return k ?? { durum: "dogrulanamadi", neden: "Bu DOI Crossref kataloğunda bulunamadı." };
+    return y.success ? crossrefKunye(y.data.message) : null;
 }
 async function isbnIle(f, isbn) {
     const ol = new URL(OPENLIBRARY);
@@ -228,18 +364,20 @@ async function isbnIle(f, isbn) {
     const c = gy.success
         ? gy.data.items?.find((x) => (x.volumeInfo.industryIdentifiers ?? []).some((i) => i.identifier.replace(/-/gu, "") === isbn))
         : undefined;
-    return c ? googleKunye(c) : { durum: "dogrulanamadi", neden: "Bu ISBN Open Library ve Google Books'ta bulunamadı." };
+    return c ? googleKunye(c) : null;
 }
-async function baslikIle(f, baslik, yazar) {
+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));
-    const c = gy.success
-        ? gy.data.items?.find((x) => baslikEslesir(baslik, x.volumeInfo.title) && yazarEslesir(yazar, x.volumeInfo.authors ?? []))
-        : undefined;
-    if (c)
-        return googleKunye(c);
+    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);
@@ -248,13 +386,10 @@ async function baslikIle(f, baslik, yazar) {
     if (cy.success)
         for (const e of cy.data.message.items) {
             const k = crossrefKunye(e);
-            if (k && baslikEslesir(baslik, k.baslik) && yazarEslesir(yazar, k.yazarlar))
+            if (k && uygun(k))
                 return k;
         }
-    return {
-        durum: "dogrulanamadi",
-        neden: "Bu başlık ve yazarla eşleşen eser Google Books ve Crossref kataloglarında bulunamadı.",
-    };
+    return null;
 }
 const KaynakSorgusu = z
     .object({
@@ -262,25 +397,31 @@ const KaynakSorgusu = z
     isbn: z.string().trim().max(30).optional(),
     baslik: z.string().trim().min(2).max(300).optional(),
     yazar: z.string().trim().min(2).max(120).optional(),
+    tur: z
+        .enum(["kitap", "makale", "kitap_bolumu", "herhangi"])
+        .optional()
+        .describe("Aranan kayıt türü. Kitap aranıyorsa dergi makalesi kabul edilmez. ISBN verilirse varsayılan kitap."),
+    yil: z.number().int().min(1400).max(2100).optional().describe("Biliniyorsa yayın yılı; kayıtla birebir uymalı"),
 })
     .refine((k) => k.doi || k.isbn || (k.baslik && k.yazar), {
     message: "DOI, ISBN ya da başlık ile yazar verin.",
 });
 /** Tek kaynağı doğrular. DOI önce, sonra ISBN, sonra başlık+yazar. */
 export async function kaynakDogrula(f, k) {
+    const ek = { tur: k.tur, yil: k.yil };
     if (k.doi) {
         const d = doiTemizle(k.doi);
         if (!d)
-            return { durum: "dogrulanamadi", neden: "DOI biçimi geçersiz (10.xxxx/... olmalı)." };
-        return doiIle(f, d);
+            return bulunamadi("DOI biçimi geçersiz (10.xxxx/... olmalı).");
+        return sonla(await doiIle(f, d), "doi", ek, "Bu DOI Crossref kataloğunda bulunamadı.");
     }
     if (k.isbn) {
         const i = isbnTemizle(k.isbn);
         if (!i)
-            return { durum: "dogrulanamadi", neden: "ISBN geçersiz (denetim basamağı tutmuyor)." };
-        return isbnIle(f, i);
+            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 baslikIle(f, k.baslik ?? "", k.yazar ?? "");
+    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 KATALOG_KAYNAKLARI = [
     { ad: "Crossref REST API", adres: "https://api.crossref.org" },
@@ -290,14 +431,14 @@ const KATALOG_KAYNAKLARI = [
 export const kaynakDogrulaAraci = arac({
     ad: "kaynak_dogrula",
     baslik: "Kaynağın gerçekten var olduğunu doğrula",
-    aciklama: "DOI, ISBN ya da başlık ile yazar verilen eserleri açık kataloglarda (Crossref, Open Library, Google Books) arar. Bulursa katalogdaki bilgiden künye ve açılabilir bağlantı döndürür; bulamazsa 'doğrulanamadı' der. Önerilecek her kaynak önce bu araçtan geçer.",
-    sonrakiAdim: "Yalnız durumu 'dogrulandi' olan kaynakları hocaya künyesi ve bağlantısıyla numaralı seçenek olarak gösterin. 'dogrulanamadi' olan kaynağı asla önermeyin, künyesini yazmayın; yerine başka bir aday arayıp yeniden doğrulayın.",
+    aciklama: "DOI, ISBN ya da başlık ile yazar verilen eserleri (çağrı başına en çok 5) açık kataloglarda (Crossref, Open Library, Google Books) arar. Eşleşme için tam soyad, başlık sözcükleri, verildiyse kayıt türü ve yıl denetlenir. Bulursa katalogdaki bilgiden künye, bağlantı ve imza döndürür ('katalogda_bulundu'); bulamazsa 'bulunamadi' der. Katalogda bulunmak ders kaynağı olarak uygunluk demek değildir; ona hoca karar verir.",
+    sonrakiAdim: "Yalnız 'katalogda_bulundu' olan kaynakları hocaya künyesi ve bağlantısıyla gösterin; uygunluğuna hoca karar verir. Bologna araçlarına kaynağı { kunye, dogrulama: { durum, baglanti, imza } } olarak aynen verin. 'bulunamadi' olan kaynağı asla kendiniz önermeyin; hoca o eseri kullandığını söylerse yalnız hocanın verdiği bilgiyle dogrulama: 'hoca_beyani' olarak yazın.",
     kunyeAlanlari: ["kaynaklar"],
     disAg: true,
     // Künye ve katalog numaraları kişisel veri değildir; ISBN gibi uzun sayılar numara deseniyle karışmasın.
     kisiselVeriKapsami: "yok",
     girdi: z.object({
-        kaynaklar: z.array(KaynakSorgusu).min(1).max(10),
+        kaynaklar: z.array(KaynakSorgusu).min(1).max(EN_COK_KAYNAK),
     }),
     calistir: async ({ kaynaklar }, b) => {
         const f = b.fetch ?? globalThis.fetch;
@@ -305,13 +446,13 @@ export const kaynakDogrulaAraci = arac({
             throw new AracHatasi("Bu ortamda dış katalog sorgusu yapılamıyor. Kaynakları şimdilik önermeyin.");
         const sonuclar = await Promise.all(kaynaklar.map((k) => kaynakDogrula(f, k)));
         const liste = sonuclar.map((s, i) => ({ no: i + 1, ...s }));
-        const dogrulanan = liste.filter((s) => s.durum === "dogrulandi").length;
+        const bulunan = liste.filter((s) => s.durum === "katalogda_bulundu").length;
         return {
             sonuc: {
                 kaynaklar: liste,
-                dogrulanan,
-                dogrulanamayan: liste.length - dogrulanan,
-                kural: "Doğrulanamayan kaynak önerilmez. Künye katalog bilgisinden kurulur; katalogda olmayan alan [EKSİK] kalır.",
+                katalogdaBulunan: bulunan,
+                bulunamayan: liste.length - bulunan,
+                kural: "Katalogda bulunmayan kaynak asistanca önerilmez; hoca kullandığını söylerse 'hoca_beyani' etiketiyle yazılır. Künye katalog bilgisinden kurulur; katalogda olmayan alan [EKSİK] kalır. Ders kaynağı olarak uygunluğa hoca karar verir.",
             },
             kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/kaynak-dogrula.ts", "Akredit kaynak doğrulayıcı"), ...KATALOG_KAYNAKLARI],
         };

package/dist/apps/acik-mcp/src/kisisel-veri.d.ts

@@ -3,6 +3,8 @@
  * `kunyeAnahtarlari`: altındaki metinler künye kuralıyla (yazar adı serbest) değerlendirilen alan adları.
  */
 export type KisiselVeriKapsami = "yok" | "ogrenci" | "tam";
+/** HTML ise yalnız görünen metni bırakır (betik, stil, yorum, etiket ve öznitelikler atılır). Değilse aynen döner. */
+export declare function gorunenMetin(x: string): string;
 export declare function kisiselVeriTurleri(girdi: unknown, kunyeAnahtarlari?: readonly string[], kapsam?: KisiselVeriKapsami): string[];
 export declare function kisiselVeriIletisi(turler: readonly string[]): string;
 /** Girdide giriş bilgisi var mı? Yalnız evet ya da hayır döner, değer döndürmez. */
@@ -12,4 +14,4 @@ export declare function girisBilgisiAyikla(metin: string): {
     metin: string;
     atildi: boolean;
 };
-export declare const GIRIS_BILGISI_ILETISI = "G\u00F6nderdi\u011Finiz veride parola, do\u011Frulama kodu ya da oturum \u00E7erezi olabilecek bir ifade var. Bu bilgiler yapay zek\u00E2ya ve Akredit'e hi\u00E7 verilmez; yaln\u0131z OBS'nin kendi giri\u015F ekran\u0131na siz yazars\u0131n\u0131z. O k\u0131sm\u0131 silip yeniden g\u00F6nderin. Parolan\u0131z\u0131 bir sohbete yazd\u0131ysan\u0131z OBS'de de\u011Fi\u015Ftirmeniz iyi olur.";
+export declare const GIRIS_BILGISI_ILETISI = "G\u00F6nderdi\u011Finiz veride parola, do\u011Frulama kodu ya da oturum \u00E7erezi olabilecek bir ifade var. Akredit bu bilgileri istemez; g\u00F6r\u00FClen istek reddedildi ve kaydedilmedi. Bunlar\u0131 yaln\u0131z OBS'nin kendi giri\u015F ekran\u0131na siz yazars\u0131n\u0131z. O k\u0131sm\u0131 silip yeniden g\u00F6nderin. Parolan\u0131z\u0131 bir sohbete yazd\u0131ysan\u0131z OBS'de de\u011Fi\u015Ftirmeniz iyi olur.";

package/dist/apps/acik-mcp/src/kisisel-veri.js

@@ -3,16 +3,20 @@
 //
 // Kapsam (İP-49): hocanın kendi sayfasında yayımlanmış görev bilgisi (Dersi Verenler, Koordinatör, iletişim)
 // kişisel veri sayılıp atılmaz; olduğu gibi okunur ve korunur. Araçlar kapsamı kendisi seçer:
-// - "yok": yalnız giriş bilgisi denetlenir (Bologna araçları).
-// - "ogrenci" (varsayılan): öğrenci ve kimlik verisi (T.C. kimlik no, öğrenci numarası, IBAN) reddedilir.
+// - "yok": yalnız giriş bilgisi denetlenir (kaynak doğrulama: künye ve katalog numaraları).
+// - "ogrenci" (varsayılan; Bologna araçları da bunu kullanır): öğrenci ve kimlik verisi (T.C. kimlik no, öğrenci
+//   numarası, IBAN) reddedilir. Yayımlanmış öğretim elemanı adları serbesttir.
 // - "tam": bütün desenler (not tablosu ve ÇK/PÇ: öğrenci adı ve numarası takma adla gelmelidir).
 //
 // Künye kuralı: kaynakçadaki yazar adları yayımlanmış künyedir, kişisel veri sayılmaz. Bu yüzden künye alanlarında
-// (araç bunları adıyla bildirir) kişi adı deseni aranmaz; e-posta, telefon, kimlik numarası gibi öbür desenler
-// yine aranır.
+// (araç bunları adıyla bildirir) kişi adı ve etiketsiz uzun sayı (ISBN, katalog no) deseni aranmaz; e-posta,
+// T.C. kimlik no, IBAN gibi öbür desenler yine aranır.
 //
-// Giriş bilgisi (ilke 8): parola, doğrulama kodu ve oturum çerezi sunucuya hiç girmez. Böyle bir desen görülürse
-// çağrı reddedilir; değer yanıtta tekrarlanmaz.
+// Giriş bilgisi (ilke 8): parola, doğrulama kodu ve oturum çerezi istenmez. Yine de gönderilirse (sunucu isteği
+// almadan bunu engelleyemez) desen görülür görülmez çağrı reddedilir, değer kaydedilmez ve yanıtta tekrarlanmaz.
+//
+// Başarım (dış inceleme 2026-11-05): HTML girdide desenler bütün kaynağa değil, yalnız görünen metne uygulanır
+// (betik, stil, etiket ve öznitelikler önce atılır). Bağlantı adreslerindeki sayılar da böylece numara sayılmaz.
 import { maskele } from "../../../packages/yz/src/index.js";
 const TUR_ADI = {
     KİŞİ: "kişi adı",
@@ -41,17 +45,28 @@ function metinler(deger, kunyeAnahtarlari, cikti = { genel: [], kunye: [] }, kun
 /** "ogrenci" kapsamında aranan türler; öbürleri (ad, e-posta, telefon, adres, imza) kapalıdır. */
 const OGRENCI_TURLERI = ["TCKN", "ÖĞRENCİ-NO", "IBAN"];
 const TUM_TURLER = Object.keys(TUR_ADI);
+/** HTML ise yalnız görünen metni bırakır (betik, stil, yorum, etiket ve öznitelikler atılır). Değilse aynen döner. */
+export function gorunenMetin(x) {
+    if (!/<\/?[a-z][\w-]*[\s>/]/iu.test(x))
+        return x;
+    return x
+        .replace(/<!--[\s\S]*?-->/gu, " ")
+        .replace(/<(script|style|noscript|template)\b[\s\S]*?<\/\1\s*>/giu, " ")
+        .replace(/<[^>]{0,2000}>/gu, " ")
+        .replace(/&nbsp;/gu, " ");
+}
 export function kisiselVeriTurleri(girdi, kunyeAnahtarlari = [], kapsam = "tam") {
     if (kapsam === "yok")
         return [];
     const kapali = kapsam === "ogrenci" ? TUM_TURLER.filter((t) => !OGRENCI_TURLERI.includes(t)) : [];
+    const kunyeKapali = [...new Set([...kapali, "KİŞİ", "ÖĞRENCİ-NO"])];
     const turler = new Set();
     const m = metinler(girdi, new Set(kunyeAnahtarlari));
     for (const x of m.genel)
-        for (const e of maskele(x, { kapali }).eslemeler)
+        for (const e of maskele(gorunenMetin(x), { kapali }).eslemeler)
             turler.add(e.tur);
     for (const x of m.kunye)
-        for (const e of maskele(x, { kapali: [...new Set([...kapali, "KİŞİ"])] }).eslemeler)
+        for (const e of maskele(gorunenMetin(x), { kapali: kunyeKapali }).eslemeler)
             turler.add(e.tur);
     return [...turler].map((t) => TUR_ADI[t]);
 }
@@ -85,4 +100,4 @@ export function girisBilgisiAyikla(metin) {
         .replace(/\b(set-cookie|cookie)\s*:[^\n]*/giu, at);
     return { metin: yeni, atildi };
 }
-export const GIRIS_BILGISI_ILETISI = "Gönderdiğiniz veride parola, doğrulama kodu ya da oturum çerezi olabilecek bir ifade var. Bu bilgiler yapay zekâya ve Akredit'e hiç verilmez; yalnız OBS'nin kendi giriş ekranına siz yazarsınız. O kısmı silip yeniden gönderin. Parolanızı bir sohbete yazdıysanız OBS'de değiştirmeniz iyi olur.";
+export const GIRIS_BILGISI_ILETISI = "Gönderdiğiniz veride parola, doğrulama kodu ya da oturum çerezi olabilecek bir ifade var. Akredit bu bilgileri istemez; görülen istek reddedildi ve kaydedilmedi. Bunları yalnız OBS'nin kendi giriş ekranına siz yazarsınız. O kısmı silip yeniden gönderin. Parolanızı bir sohbete yazdıysanız OBS'de değiştirmeniz iyi olur.";

package/dist/apps/acik-mcp/src/not-tablosu.d.ts

@@ -8,6 +8,8 @@ export declare function tabloOku(metin: string): {
 };
 /** Kimlik sütunları: başlıktan ya da içerikten (çoğunluğu harfli metin ya da 7+ haneli sayı). */
 export declare function kimlikSutunlari(satirlar: string[][]): number[];
+/** Kimlik sütunu olmayan tablonun başına o1, o2 takma ad sütunu ekler. Başlıkta zaten takma ad varsa dokunmaz. */
+export declare function takmaAdEkle(metin: string): string;
 /** Tablodan kimlik sütunlarını atar, başa o1, o2 takma adı koyar. Yalnız bellekte çalışır. */
 export declare function notTablosuAyikla(metin: string): {
     tablo: string;
@@ -24,6 +26,10 @@ export interface Sutun {
 }
 /** Sütun başlığından araç, soru, tam puan ve ÇK eşlemesi sezgisi. "Vize S1 (ÇK2) /20" gibi. */
 export declare function sutunCoz(baslik: string): Sutun | null;
+/** Kişisel veri görülünce verilen ileti (aynen). */
+export declare const NOT_TABLOSU_KISISEL_ILETI = "Ki\u015Fisel veriyi yapay zek\u00E2 sohbetine yap\u0131\u015Ft\u0131rmay\u0131n: Excel'de Ad, Soyad, Numara s\u00FCtunlar\u0131n\u0131 silip yaln\u0131z not s\u00FCtunlar\u0131n\u0131 yap\u0131\u015Ft\u0131r\u0131n ya da verinin taray\u0131c\u0131n\u0131zdan \u00E7\u0131kmad\u0131\u011F\u0131 hesaplay\u0131c\u0131y\u0131 kullan\u0131n: https://akredit.org/deneyin";
+/** Tabloda kimlik sütunu (ad, soyad, numara...) ya da 9-11 haneli numara var mı? Varsa red iletisi döner. */
+export declare function notTablosuKisiselVeri(metin: string): string | null;
 export declare const SUTUN_ESLEME_REHBERI: string[];
 export declare const notTablosuAyristirAraci: import("./temel.ts").AcikArac<z.ZodObject<{
     tablo: z.ZodString;

package/dist/apps/acik-mcp/src/not-tablosu.js

@@ -1,6 +1,10 @@
-// Excel ya da CSV'den yapıştırılan not tablosunu ck_pc_hesapla girdisine hazırlar. Öğrenci kimliği (ad, soyad,
-// numara, e-posta) ayrıştırmadan önce bellekte atılır ve satır sırasına göre o1, o2, ... takma adı verilir; atılan
-// değerler hiçbir yere yazılmaz. Sütun başlıklarından ölçme aracı, soru numarası, tam puan ve ders çıktısı (ÇK)
+// Excel ya da CSV'den yapıştırılan not tablosunu ck_pc_hesapla girdisine hazırlar. Öğrenciler satır sırasına göre
+// o1, o2, ... takma adı alır.
+//
+// Kişisel veri (dış inceleme 2026-11-05): tablo sohbete yapıştırıldığı anda yapay zekâ sağlayıcısına gitmiştir;
+// sunucunun sonradan sütun atması bunu geri almaz. Bu yüzden ad, soyad ya da öğrenci numarası sütunu ya da 9-11
+// haneli bir numara görülürse tablo işlenmez; hoca bu sütunları Excel'de silip yalnız not sütunlarını yapıştırır ya
+// da verinin tarayıcıdan çıkmadığı hesaplayıcıyı kullanır. Değerler hiçbir yere yazılmaz. Sütun başlıklarından ölçme aracı, soru numarası, tam puan ve ders çıktısı (ÇK)
 // eşlemesi sezilir; sezilemeyen bilgi tahmin edilmez, eksikler listesine girer. Sayılar yalnız tablodan okunur.
 import { z } from "zod";
 import { arac, KOD_KAYNAGI } from "./temel.js";
@@ -59,6 +63,13 @@ export function kimlikSutunlari(satirlar) {
     });
     return sonuc;
 }
+/** Kimlik sütunu olmayan tablonun başına o1, o2 takma ad sütunu ekler. Başlıkta zaten takma ad varsa dokunmaz. */
+export function takmaAdEkle(metin) {
+    const { satirlar } = tabloOku(metin);
+    if (satirlar.length < 2 || /^takma ad$/iu.test((satirlar[0]?.[0] ?? "").trim()))
+        return metin;
+    return satirlar.map((r, i) => [i === 0 ? "Takma ad" : `o${i}`, ...r].join("\t")).join("\n");
+}
 /** Tablodan kimlik sütunlarını atar, başa o1, o2 takma adı koyar. Yalnız bellekte çalışır. */
 export function notTablosuAyikla(metin) {
     const { satirlar } = tabloOku(metin);
@@ -110,11 +121,23 @@ const puanOku = (s, ayirac) => {
     const n = Number(ayirac === "," ? t : t.replace(",", "."));
     return Number.isFinite(n) ? n : null;
 };
+/** Kişisel veri görülünce verilen ileti (aynen). */
+export const NOT_TABLOSU_KISISEL_ILETI = "Kişisel veriyi yapay zekâ sohbetine yapıştırmayın: Excel'de Ad, Soyad, Numara sütunlarını silip yalnız not sütunlarını yapıştırın ya da verinin tarayıcınızdan çıkmadığı hesaplayıcıyı kullanın: https://akredit.org/deneyin";
+const UZUN_NUMARA = /(?<![\d.,])\d{9,11}(?![\d.,]\d)/u;
+/** Tabloda kimlik sütunu (ad, soyad, numara...) ya da 9-11 haneli numara var mı? Varsa red iletisi döner. */
+export function notTablosuKisiselVeri(metin) {
+    const { satirlar } = tabloOku(metin);
+    if (satirlar.length >= 2 && kimlikSutunlari(satirlar).length)
+        return NOT_TABLOSU_KISISEL_ILETI;
+    if (satirlar.some((r) => r.some((h) => UZUN_NUMARA.test(h.replace(/\s/gu, "")))))
+        return NOT_TABLOSU_KISISEL_ILETI;
+    return null;
+}
 export const SUTUN_ESLEME_REHBERI = [
     "Excel'de ilk satır başlık olsun: her soru ya da ölçme için bir sütun.",
     "Başlık örnekleri: 'Vize S1 (ÇK1) /20', 'Vize S2 (ÇK2) /30', 'Final S1 ÇK3 /50', 'Ödev ÇK4 /100'.",
     "Başlıkta sınavın adı (Vize, Final, Ödev, Proje, Quiz), soru numarası (S1, Soru 2), ölçtüğü ders çıktısı (ÇK1 ya da Ö1) ve tam puanı (/20 ya da (20p)) olsun.",
-    "Ad, soyad ve numara sütunlarını silmenize gerek yok: araç onları ayrıştırmadan önce atar ve o1, o2 diye takma ad verir. Yine de silerseniz daha iyi olur.",
+    "Ad, Soyad ve Numara sütunlarını yapıştırmadan önce Excel'de silin: yalnız not sütunları gelsin. Kimlik sütunu ya da numara görülürse tablo işlenmez. Öğrenciler o1, o2 diye takma ad alır.",
     "Toplam, Ortalama, Harf sütunları yok sayılır.",
     "Boş, '-' ya da 'G' (girmedi) hücreleri boş puan sayılır.",
     "Tabloyu Excel'de seçip Ctrl+C ile kopyalayın, sohbete Ctrl+V ile yapıştırın.",
@@ -122,25 +145,27 @@ export const SUTUN_ESLEME_REHBERI = [
 export const notTablosuAyristirAraci = arac({
     ad: "not_tablosu_ayristir",
     baslik: "Not tablosunu ayrıştır",
-    aciklama: "Excel ya da CSV'den yapıştırılan not tablosunu ÇK/PÇ hesabına hazırlar. Ad, soyad ve numara sütunlarını ayrıştırmadan önce atar, öğrencilere o1, o2 takma adı verir. Başlıklardan sınav, soru, tam puan ve ders çıktısı eşlemesini sezer; eksikleri listeler.",
+    aciklama: "Excel ya da CSV'den yapıştırılan not tablosunu ÇK/PÇ hesabına hazırlar. Tabloda yalnız not sütunları olmalı: ad, soyad ya da numara sütunu ya da 9-11 haneli numara görülürse tablo işlenmez. Öğrencilere o1, o2 takma adı verir. Başlıklardan sınav, soru, tam puan ve ders çıktısı eşlemesini sezer; eksikleri listeler.",
     sonrakiAdim: "Sezilen eşlemeyi hocaya tablo olarak gösterin ve eksikleri tek tek seçenekle sorun (ör. S3 hangi çıktıyı ölçüyor? 1) Ö2 2) Ö3). Eksik kalmayınca ckPcHesaplaTaslagi'ni ck_pc_hesapla'ya verin.",
-    kisiselVeriIpucu: "Kimlik sütunları atıldıktan sonra da kişisel veri kaldı. Ad ya da numara içeren başka sütun varsa silip yeniden yapıştırın.",
+    kisiselVeriIpucu: NOT_TABLOSU_KISISEL_ILETI,
     kisiselVeriKapsami: "tam",
+    onDenetim: (g) => {
+        const t = g?.tablo;
+        return typeof t === "string" ? notTablosuKisiselVeri(t) : null;
+    },
     onAyikla: (g) => {
+        // Kimlik sütunu yoksa tablo yalnız not sütunlarıdır; başa o1, o2 takma adı eklenir (sütun atılmaz).
         const t = g?.tablo;
         if (typeof t !== "string")
             return { girdi: g, atilan: [] };
-        const r = notTablosuAyikla(t);
-        return {
-            girdi: { ...g, tablo: r.tablo },
-            atilan: r.atilan,
-            ileti: r.atilan.length
-                ? `Öğrenci kimliği taşıyan sütunlar hesaplamadan önce atıldı, öğrencilere o1, o2 takma adı verildi; hiçbir yere yazılmadı: ${r.atilan.join(", ")}.`
-                : undefined,
-        };
+        return { girdi: { ...g, tablo: takmaAdEkle(t) }, atilan: [] };
     },
     girdi: z.object({
-        tablo: z.string().min(5).max(2_000_000).describe("Excel ya da CSV'den yapıştırılan tablo; ilk satır başlık"),
+        tablo: z
+            .string()
+            .min(5)
+            .max(400_000)
+            .describe("Excel ya da CSV'den yapıştırılan, yalnız not sütunlarından oluşan tablo; ilk satır başlık"),
         tamPuanlar: z
             .record(z.string().max(80), z.number().positive().max(1000))
             .optional()

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

@@ -12,6 +12,8 @@ export declare const GIRIS_BILGISI_KURALI: string;
 /** Akıllı doldurma kısayolu: bütün menülerde aynı numara ve aynı anlam. */
 export declare const AKILLI_DOLDURMA_SECENEGI = "4) Hepsini ak\u0131ll\u0131ca doldur (\u00F6nerilen)";
 /** "4) Hepsini akıllıca doldur" seçildiğinde (ya da hoca "sen seç", "hepsi" derse) izlenecek yol. */
+/** Bilinmesi mümkün olmayan ve resmî taahhüt olan bilgiler: sayfadan okunur, yoksa tek mesajda sorulur. */
+export declare const TEYIT_SORULARI: string;
 export declare const AKILLI_DOLDURMA: string;
 /** Bütün istemlerde ortak çalışma biçimi. */
 export declare const ORTAK_KURALLAR: string;
@@ -21,5 +23,26 @@ export declare const AKREDIT_ODAKLARI: readonly {
     ad: string;
 }[];
 export declare const ACIK_ISTEMLER: readonly AcikIstem[];
+/** Kısa kurallar: akredit_basla yanıtında (istem desteklemeyen istemciler için) yer alır. */
+export declare const KISA_KURALLAR: string[];
+/** akredit_basla aracının yanıtı: menü, kısa kurallar ve her seçimin akışı (istem desteklemeyen istemciler için). */
+export declare function baslangic(): {
+    hocayaGoster: string;
+    menu: ({
+        no: "1" | "2" | "3" | "4" | "5";
+        ad: "Bologna ders paketini denetle ve boş alanları doldur" | "Ders öğrenme çıktısı yaz ya da iyileştir" | "ÇK ve PÇ sağlanma düzeyini hesapla" | "YÖKAK, MÜDEK, FEDEK, EPDAD ya da SABAK ölçüt ve kanıt rehberi" | "Öz değerlendirme metninin dil denetimi";
+        istem: "bologna_doldur" | "cikti_yaz" | "ck_pc_hesabi" | "olcut_rehberi" | "dil_denetimi";
+    } | {
+        no: string;
+        ad: string;
+        istem: null;
+    })[];
+    kisaKurallar: string[];
+    akislar: {
+        [k: string]: string;
+    };
+    ortakKurallar: string;
+};
+export declare const akreditBaslaAraci: import("./temel.ts").AcikArac<z.ZodObject<{}, z.core.$strip>>;
 /** SDK için bağımsız değişken şeması: hepsi isteğe bağlı, kısa metin. */
 export declare const istemSemasi: (i: AcikIstem) => Record<string, z.ZodOptional<z.ZodString>>;