@akredit/acik-mcp 0.1.0 → 0.5.0

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

@@ -0,0 +1,155 @@
+// Kaynak künyesi biçimlendirme: APA 7'ye benzer, Türkçe kısaltmalı, deterministik. Yalnız verilen bilgiyi dizer;
+// eksik bilgi tahmin edilmez, künyede [EKSİK: ...] olarak görünür. Yazar adları yayımlanmış künyedir; bu araçta
+// kişi adı deseni aranmaz (künye kuralı), e-posta ve telefon yine reddedilir.
+import { z } from "zod";
+import { arac, KOD_KAYNAGI } from "./temel.js";
+const Kaynak = z.object({
+    tur: z.enum(["kitap", "makale", "kitap_bolumu", "web", "tez"]).default("kitap"),
+    yazarlar: z
+        .array(z.string().trim().min(2).max(120))
+        .max(25)
+        .default([])
+        .describe("'Soyad, Ad' ya da 'Ad Soyad'; kurum adı da olabilir"),
+    kurumYazar: z.boolean().default(false).describe("Yazar bir kurumsa (ör. Kurgu Bakanlığı) true"),
+    yil: z.union([z.number().int().min(1400).max(2100), z.string().trim().max(20)]).optional(),
+    baslik: z.string().trim().min(2).max(400),
+    baski: z.number().int().min(2).max(50).optional(),
+    yayinevi: z.string().trim().max(200).optional(),
+    dergi: z.string().trim().max(200).optional(),
+    cilt: z.string().trim().max(20).optional(),
+    sayi: z.string().trim().max(20).optional(),
+    sayfalar: z.string().trim().max(30).optional().describe("ör. '12-30'"),
+    editorler: z.array(z.string().trim().min(2).max(120)).max(10).optional(),
+    kitapBasligi: z.string().trim().max(400).optional(),
+    kurum: z.string().trim().max(200).optional().describe("Tezde üniversite"),
+    tezTuru: z.enum(["yuksek_lisans", "doktora"]).optional(),
+    site: z.string().trim().max(200).optional(),
+    doi: z.string().trim().max(200).optional(),
+    url: z.string().trim().max(500).optional(),
+});
+const bas = (s) => {
+    const h = [...s.trim()][0] ?? "";
+    return h ? `${h.toLocaleUpperCase("tr")}.` : "";
+};
+/** "Soyad, Ad İkinci" ya da "Ad İkinci Soyad" → "Soyad, A. İ." */
+export function yazarBicimle(ad, kurum = false) {
+    const a = ad.trim().replace(/\s+/gu, " ");
+    if (kurum)
+        return a;
+    if (a.includes(",")) {
+        const [soyad, ...ilk] = a.split(",");
+        const adlar = ilk
+            .join(" ")
+            .trim()
+            .split(/[\s-]+/u)
+            .filter(Boolean);
+        return [soyad?.trim(), adlar.map(bas).join(" ")].filter(Boolean).join(", ");
+    }
+    const p = a.split(" ");
+    if (p.length === 1)
+        return a;
+    const soyad = p.at(-1) ?? "";
+    return `${soyad}, ${p.slice(0, -1).map(bas).join(" ")}`;
+}
+/** APA 7: 1 yazar "A"; 2 yazar "A, & B"; 3-20 yazar virgülle, sonuncudan önce "&"; 21+ ilk 19, "...", son. */
+export function yazarListesi(yazarlar, kurum = false) {
+    const b = yazarlar.map((y) => yazarBicimle(y, kurum));
+    if (b.length === 0)
+        return "";
+    if (b.length === 1)
+        return b[0] ?? "";
+    if (b.length <= 20)
+        return `${b.slice(0, -1).join(", ")}, & ${b.at(-1)}`;
+    return `${b.slice(0, 19).join(", ")}, ... ${b.at(-1)}`;
+}
+const nokta = (s) => (/[.?!]$/u.test(s) ? s : `${s}.`);
+const doiBagi = (d) => (/^https?:\/\//u.test(d) ? d : `https://doi.org/${d.replace(/^doi:\s*/iu, "")}`);
+const editorKisa = (e) => {
+    const b = yazarBicimle(e);
+    const [soyad, bas] = b.split(", ");
+    return bas ? `${bas} ${soyad}` : b;
+};
+/** Tek künye. Eksik zorunlu bilgi [EKSİK: ...] olarak yazılır ve ayrıca listelenir. */
+export function kunyeBicimle(k) {
+    const eksikler = [];
+    const eksik = (ad) => {
+        eksikler.push(ad);
+        return `[EKSİK: ${ad}]`;
+    };
+    const yazar = k.yazarlar.length ? yazarListesi(k.yazarlar, k.kurumYazar) : eksik("yazar");
+    const yil = k.yil === undefined || k.yil === "" ? "t.y." : String(k.yil);
+    if (yil === "t.y.")
+        eksikler.push("yıl (t.y. yazıldı)");
+    const parcalar = [`${nokta(yazar)} (${yil}).`];
+    const baski = k.baski ? ` (${k.baski}. bs.)` : "";
+    switch (k.tur) {
+        case "kitap":
+            parcalar.push(nokta(`${k.baslik}${baski}`), nokta(k.yayinevi || eksik("yayınevi")));
+            break;
+        case "makale": {
+            parcalar.push(nokta(k.baslik));
+            const dergi = k.dergi || eksik("dergi adı");
+            const cilt = k.cilt ? `, ${k.cilt}${k.sayi ? `(${k.sayi})` : ""}` : "";
+            const sayfa = k.sayfalar ? `, ${k.sayfalar}` : "";
+            parcalar.push(nokta(`${dergi}${cilt}${sayfa}`));
+            if (!k.cilt)
+                eksikler.push("cilt");
+            if (!k.sayfalar)
+                eksikler.push("sayfalar");
+            break;
+        }
+        case "kitap_bolumu": {
+            parcalar.push(nokta(k.baslik));
+            const ed = k.editorler?.length
+                ? `${k.editorler.map(editorKisa).join(", ")} (${k.editorler.length > 1 ? "Ed'ler" : "Ed."}), `
+                : "";
+            const kitap = k.kitapBasligi || eksik("kitap adı");
+            const ss = k.sayfalar ? ` (ss. ${k.sayfalar})` : "";
+            parcalar.push(nokta(`İçinde ${ed}${kitap}${baski}${ss}`), nokta(k.yayinevi || eksik("yayınevi")));
+            break;
+        }
+        case "tez": {
+            const tur = k.tezTuru === "doktora"
+                ? "Doktora tezi"
+                : k.tezTuru === "yuksek_lisans"
+                    ? "Yüksek lisans tezi"
+                    : eksik("tez türü");
+            parcalar.push(`${k.baslik} [${tur}, ${k.kurum || eksik("üniversite")}].`);
+            break;
+        }
+        case "web":
+            parcalar.push(nokta(k.baslik));
+            if (k.site)
+                parcalar.push(nokta(k.site));
+            if (!k.url)
+                parcalar.push(eksik("adres"));
+            break;
+    }
+    if (k.doi)
+        parcalar.push(doiBagi(k.doi));
+    else if (k.url)
+        parcalar.push(k.url);
+    return { kunye: parcalar.join(" ").replace(/\s+/gu, " ").trim(), eksikler };
+}
+export const kaynakBicimleAraci = arac({
+    ad: "kaynak_bicimle",
+    baslik: "Kaynak künyesi biçimle",
+    aciklama: "Hocanın verdiği kitap, makale, kitap bölümü, tez ya da web kaynağını APA 7'ye benzer Türkçe künyeye çevirir. Yalnız verilen bilgiyi dizer; eksik bilgi [EKSİK] olarak görünür, uydurulmaz.",
+    sonrakiAdim: "Künyeleri hocaya gösterin. Eserin varlığını kaynak_dogrula ile doğrulayın; doğrulanamayanı yazmayın. EKSİK bilgiyi tahmin etmeyin. Sonra künyeleri kaynaklar alanına koyun.",
+    kunyeAlanlari: ["kaynaklar"],
+    girdi: z.object({
+        kaynaklar: z.array(Kaynak).min(1).max(30),
+    }),
+    calistir: ({ kaynaklar }) => {
+        const sonuclar = kaynaklar.map((k, i) => ({ no: i + 1, ...kunyeBicimle(k) }));
+        return {
+            sonuc: {
+                kunyeler: sonuclar,
+                tamamlanan: sonuclar.filter((s) => !s.eksikler.length).length,
+                not: "Biçim APA 7'ye benzer bir Akredit biçimidir; kurumunuzun yazım kılavuzu farklıysa o önceliklidir. Eser bilgisinin doğruluğunu hoca denetler.",
+                uydurmaYok: "Bu araç yalnız verilen bilgiyi biçimlendirir. Asistan, kaynak_dogrula ile doğrulanmamış bir eseri önermez.",
+            },
+            kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/kaynak.ts", "Akredit künye biçimleyici")],
+        };
+    },
+});

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

@@ -1,3 +1,17 @@
-/** Girdide kişisel veri olabilecek türlerin adları (değerler değil). Boşsa temiz. */
-export declare function kisiselVeriTurleri(girdi: unknown): string[];
+/**
+ * Girdide kişisel veri olabilecek türlerin adları (değerler değil). Boşsa temiz.
+ * `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. */
+export declare function girisBilgisiVar(girdi: unknown): boolean;
+/** Yapıştırılan sayfadan oturum kimliklerini, parola kutularını ve çerez satırlarını bellekte atar. */
+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. 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

@@ -1,7 +1,22 @@
-// Gelen veride kişisel veri denetimi. Açık sunucu kişisel veri işlemez (CLAUDE.md ilke 7): desen görülürse
-// istek reddedilir, kullanıcıdan maskeleyip yeniden göndermesi istenir. Bulunan değer hiçbir yere yazılmaz,
-// yalnız türü söylenir. Desenler @akredit/yz KVKK maskeleyicisinden gelir (TCKN, telefon, e-posta, IBAN,
-// öğrenci numarası, unvanlı ya da yaygın adla başlayan kişi adı, adres, imza).
+// Gelen veride kişisel veri ve giriş bilgisi denetimi. Bulunan değer hiçbir yere yazılmaz, yalnız türü söylenir.
+// Desenler @akredit/yz KVKK maskeleyicisinden gelir.
+//
+// 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 (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ı 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 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ı",
@@ -13,28 +28,76 @@ const TUR_ADI = {
     ADRES: "adres",
     İMZA: "imza",
 };
-/** Bir girdideki bütün metinleri (anahtarlar dahil) gezer. */
-function metinler(deger, cikti = []) {
+/** Bir girdideki bütün metinleri (anahtarlar dahil) gezer; künye alanlarındaki metinleri ayrı toplar. */
+function metinler(deger, kunyeAnahtarlari, cikti = { genel: [], kunye: [] }, kunyede = false) {
     if (typeof deger === "string")
-        cikti.push(deger);
+        (kunyede ? cikti.kunye : cikti.genel).push(deger);
     else if (Array.isArray(deger))
         for (const x of deger)
-            metinler(x, cikti);
+            metinler(x, kunyeAnahtarlari, cikti, kunyede);
     else if (deger !== null && typeof deger === "object")
         for (const [k, v] of Object.entries(deger)) {
-            cikti.push(k);
-            metinler(v, cikti);
+            cikti.genel.push(k);
+            metinler(v, kunyeAnahtarlari, cikti, kunyede || kunyeAnahtarlari.has(k));
         }
     return cikti;
 }
-/** Girdide kişisel veri olabilecek türlerin adları (değerler değil). Boşsa temiz. */
-export function kisiselVeriTurleri(girdi) {
+/** "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();
-    for (const m of metinler(girdi))
-        for (const e of maskele(m).eslemeler)
+    const m = metinler(girdi, new Set(kunyeAnahtarlari));
+    for (const x of m.genel)
+        for (const e of maskele(gorunenMetin(x), { kapali }).eslemeler)
+            turler.add(e.tur);
+    for (const x of m.kunye)
+        for (const e of maskele(gorunenMetin(x), { kapali: kunyeKapali }).eslemeler)
             turler.add(e.tur);
     return [...turler].map((t) => TUR_ADI[t]);
 }
 export function kisiselVeriIletisi(turler) {
-    return `Gönderdiğiniz veride kişisel veri olabilecek ifadeler var (${turler.join(", ")}). Bu sunucu kişisel veri işlemez. Adları, numaraları ve iletişim bilgilerini maskeleyip (ör. "Öğrenci 1", "[KİŞİ-1]") yeniden gönderin.`;
+    return `Gönderdiğiniz veride kişisel veri olabilecek ifadeler var (${turler.join(", ")}). Öğrenci ve kimlik bilgileri bu araca takma adla gelmelidir. Bu kısımları takma adla (ör. "o1", "Öğrenci 1") değiştirip yeniden gönderin.`;
+}
+const OTURUM_KIMLIGI = /\b(jsessionid|phpsessid|asp\.net_sessionid|aspsessionid\w*|sessionid|connect\.sid|laravel_session|\.aspxauth)\s*=\s*[\w%.-]{6,}/iu;
+/** Giriş bilgisi desenleri: etiketli parola ya da doğrulama kodu, çerez başlığı, oturum kimliği, erişim belirteci. */
+const GIRIS_DESENLERI = [
+    /(^|[^\p{L}])(parola|şifre|sifre|password|passwd|pwd)\s*[:=]\s*\S+/iu,
+    /(doğrulama kodu|dogrulama kodu|onay kodu|tek kullanımlık kod|sms kodu|verification code|otp|2fa kodu)\s*[:=]?\s*\d{4,8}(?!\d)/iu,
+    /\b(set-cookie|cookie)\s*:\s*\S+=/iu,
+    OTURUM_KIMLIGI,
+    /\bBearer\s+[\w.~+/-]{16,}=*/u,
+];
+/** Girdide giriş bilgisi var mı? Yalnız evet ya da hayır döner, değer döndürmez. */
+export function girisBilgisiVar(girdi) {
+    const m = metinler(girdi, new Set());
+    return [...m.genel, ...m.kunye].some((x) => GIRIS_DESENLERI.some((d) => d.test(x)));
+}
+/** Yapıştırılan sayfadan oturum kimliklerini, parola kutularını ve çerez satırlarını bellekte atar. */
+export function girisBilgisiAyikla(metin) {
+    let atildi = false;
+    const at = () => {
+        atildi = true;
+        return "";
+    };
+    const yeni = metin
+        .replace(new RegExp(OTURUM_KIMLIGI.source, "giu"), at)
+        .replace(/<input\b[^>]*type\s*=\s*["']?password[^>]*>/giu, at)
+        .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. 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

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export type Ayirac = "\t" | ";" | ",";
+export declare function ayiracBul(metin: string): Ayirac;
+/** Basit CSV/TSV ayrıştırma; çift tırnaklı hücreleri destekler. */
+export declare function tabloOku(metin: string): {
+    ayirac: Ayirac;
+    satirlar: 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;
+    atilan: string[];
+};
+export interface Sutun {
+    baslik: string;
+    aracId: string;
+    tur: string;
+    aracAdi: string;
+    soruNo: string;
+    ciktilar: string[];
+    tamPuan: number | null;
+}
+/** 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;
+    tamPuanlar: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    eslemeler: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    agirliklar: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>>;

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

@@ -0,0 +1,268 @@
+// 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";
+export function ayiracBul(metin) {
+    const satirlar = metin
+        .split(/\r?\n/u)
+        .filter((s) => s.trim())
+        .slice(0, 5);
+    if (satirlar.some((s) => s.includes("\t")))
+        return "\t";
+    const say = (c) => satirlar.reduce((t, s) => t + s.split(c).length - 1, 0);
+    return say(";") >= say(",") && say(";") > 0 ? ";" : ",";
+}
+/** Basit CSV/TSV ayrıştırma; çift tırnaklı hücreleri destekler. */
+export function tabloOku(metin) {
+    const ayirac = ayiracBul(metin);
+    const satirlar = metin
+        .split(/\r?\n/u)
+        .filter((s) => s.trim())
+        .map((s) => {
+        const hucreler = [];
+        let h = "";
+        let tirnak = false;
+        for (const ch of s) {
+            if (ch === '"')
+                tirnak = !tirnak;
+            else if (ch === ayirac && !tirnak) {
+                hucreler.push(h.trim());
+                h = "";
+            }
+            else
+                h += ch;
+        }
+        hucreler.push(h.trim());
+        return hucreler;
+    });
+    return { ayirac, satirlar };
+}
+const KIMLIK_BASLIGI = /^(ad|adı|isim|soyad|soyadı|ad soyad|adı soyadı|ad-soyad|öğrenci|öğrenci adı|öğrenci no|öğrenci numarası|numara|numarası|no|okul no|sıra|sıra no|tc|tc no|t\.c\.|tc kimlik|kimlik|e-?posta|email|e-mail|name|first name|last name|surname|full name|student|student id|student no|student number|student name|id)$/iu;
+const HESAP_BASLIGI = /^(toplam|ortalama|ort|not|harf|harf notu|başarı notu|sonuç|durum|total|average|grade|letter|result)$/iu;
+const kucuk = (s) => s.toLocaleLowerCase("tr").trim();
+/** Başlık eşlemesi: hem olduğu gibi (ID) hem Türkçe küçük harfle (ADI SOYADI) denenir. */
+const esler = (re, b) => re.test(b.trim()) || re.test(kucuk(b));
+/** Kimlik sütunları: başlıktan ya da içerikten (çoğunluğu harfli metin ya da 7+ haneli sayı). */
+export function kimlikSutunlari(satirlar) {
+    const [baslik = [], ...veri] = satirlar;
+    const sonuc = [];
+    baslik.forEach((b, j) => {
+        const degerler = veri.map((r) => r[j] ?? "").filter((x) => x.trim());
+        const harfli = degerler.filter((x) => /\p{L}{2,}/u.test(x) && !/^[-–]?$/u.test(x)).length;
+        const uzunSayi = degerler.filter((x) => /^\d{7,}$/u.test(x.replace(/\s/gu, ""))).length;
+        const yari = degerler.length / 2;
+        if (esler(KIMLIK_BASLIGI, b) || (degerler.length && (harfli > yari || uzunSayi > yari)))
+            if (!esler(HESAP_BASLIGI, b) || uzunSayi > yari)
+                sonuc.push(j);
+    });
+    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);
+    if (satirlar.length < 2)
+        return { tablo: metin, atilan: [] };
+    const kimlik = new Set(kimlikSutunlari(satirlar));
+    const baslik = satirlar[0] ?? [];
+    const atilan = [...kimlik].map((j) => `"${(baslik[j] ?? `${j + 1}. sütun`).slice(0, 30)}" sütunu`);
+    const yeni = satirlar.map((r, i) => [i === 0 ? "Takma ad" : `o${i}`, ...r.filter((_, j) => !kimlik.has(j))]);
+    return { tablo: yeni.map((r) => r.join("\t")).join("\n"), atilan };
+}
+const ARAC_TURLERI = [
+    [/^(vize|ara ?sınav|ara|midterm|mt|as)\b/iu, "ara_sinav", "Ara Sınav"],
+    [/^(final|yarıyıl sonu|yys|fin|dönem sonu)\b/iu, "yariyil_sonu", "Yarıyıl Sonu Sınavı"],
+    [/^(bütünleme|but|bütünleme sınavı|makeup|resit)\b/iu, "butunleme", "Bütünleme"],
+    [/^(quiz|kısa ?sınav|ks)\b/iu, "kisa_sinav", "Kısa Sınav"],
+    [/^(ödev|odev|hw|homework|assignment)\b/iu, "odev", "Ödev"],
+    [/^(proje|project)\b/iu, "proje", "Proje"],
+    [/^(lab|laboratuvar|laboratory)\b/iu, "laboratuvar", "Laboratuvar"],
+    [/^(sunum|presentation)\b/iu, "sunum", "Sunum"],
+    [/^(uygulama|practice)\b/iu, "uygulama", "Uygulama"],
+];
+/** Sütun başlığından araç, soru, tam puan ve ÇK eşlemesi sezgisi. "Vize S1 (ÇK2) /20" gibi. */
+export function sutunCoz(baslik) {
+    const b = baslik.trim();
+    if (!b || esler(HESAP_BASLIGI, b))
+        return null;
+    const tur = ARAC_TURLERI.find(([re]) => re.test(b));
+    const ciktilar = [...b.matchAll(/(?:ÇK|ÖÇ|DÖÇ|LO|CLO|Ö)\s*-?\s*(\d{1,2})/giu)].map((m) => `Ö${Number(m[1])}`);
+    const tamPuanEslesme = b.match(/\/\s*(\d+(?:[.,]\d+)?)\s*$/u) ?? b.match(/\(\s*(\d+(?:[.,]\d+)?)\s*(?:p|puan|pts|points)\s*\)/iu);
+    const tamPuan = tamPuanEslesme ? Number((tamPuanEslesme[1] ?? "").replace(",", ".")) : null;
+    const sade = b
+        .replace(/(?:ÇK|ÖÇ|DÖÇ|LO|CLO|Ö)\s*-?\s*\d{1,2}/giu, "")
+        .replace(/\/\s*\d+(?:[.,]\d+)?\s*$/u, "")
+        .replace(/\(\s*\d+(?:[.,]\d+)?\s*(?:p|puan|pts|points)\s*\)/iu, "");
+    const soru = sade.match(/(?:^|[\s_.-])(?:s|soru|q|question)\s*\.?\s*(\d{1,3})\b/iu)?.[1];
+    const aracParca = tur ? (sade.match(tur[0])?.[0] ?? "") : "";
+    const aracNo = tur ? sade.slice(aracParca.length).match(/^\s*(\d)(?!\d)/u)?.[1] : undefined;
+    if (!tur && !soru)
+        return null;
+    const aracId = tur ? `${tur[1]}${aracNo ? `_${aracNo}` : ""}` : "sinav";
+    const aracAdi = tur ? `${tur[2]}${aracNo ? ` ${aracNo}` : ""}` : "Sınav";
+    return { baslik: b, aracId, tur: tur?.[1] ?? "diger", aracAdi, soruNo: soru ?? "1", ciktilar, tamPuan };
+}
+const puanOku = (s, ayirac) => {
+    const t = s.trim().replace(/\s/gu, "");
+    if (!t || /^(-|–|g|gm|girmedi|yok|na|n\/a)$/iu.test(t))
+        return null;
+    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ı 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.",
+];
+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. 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: 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: [] };
+        return { girdi: { ...g, tablo: takmaAdEkle(t) }, atilan: [] };
+    },
+    girdi: z.object({
+        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()
+            .describe("Sütun başlığı → tam puan; başlıkta yoksa"),
+        eslemeler: z
+            .record(z.string().max(80), z.array(z.string().max(10)).max(10))
+            .optional()
+            .describe("Sütun başlığı → ders çıktısı kodları (Ö1, Ö2); başlıkta yoksa"),
+        agirliklar: z
+            .record(z.string().max(40), z.number().min(0).max(100))
+            .optional()
+            .describe("Ölçme aracı kimliği (ara_sinav, yariyil_sonu, odev...) → ders notundaki yüzde"),
+    }),
+    calistir: ({ tablo, tamPuanlar = {}, eslemeler = {}, agirliklar = {} }) => {
+        const { ayirac, satirlar } = tabloOku(tablo);
+        const [baslik = [], ...veri] = satirlar;
+        const sutunlar = baslik.map((b, j) => (j === 0 ? null : sutunCoz(b)));
+        const yoksayilan = baslik.filter((_, j) => j > 0 && !sutunlar[j]);
+        const kullanilan = sutunlar
+            .map((s, j) => (s ? { ...s, j } : null))
+            .filter((s) => s !== null)
+            .map((s) => ({
+            ...s,
+            tamPuan: tamPuanlar[s.baslik] ?? s.tamPuan,
+            ciktilar: eslemeler[s.baslik] ?? s.ciktilar,
+        }));
+        const eksikler = [];
+        if (!kullanilan.length)
+            eksikler.push("Hiçbir sütunda sınav ya da soru bulunamadı. Başlıkları sütun eşleme rehberine göre düzenleyin.");
+        for (const s of kullanilan) {
+            if (s.tamPuan === null)
+                eksikler.push(`"${s.baslik}" sütununun tam puanı yok.`);
+            if (!s.ciktilar.length)
+                eksikler.push(`"${s.baslik}" sütununun hangi ders çıktısını ölçtüğü yok.`);
+        }
+        const aracIdleri = [...new Set(kullanilan.map((s) => s.aracId))];
+        for (const id of aracIdleri)
+            if (agirliklar[id] === undefined)
+                eksikler.push(`"${id}" ölçme aracının ders notundaki yüzdesi yok.`);
+        // Aynı araçta aynı soru numarası iki kez geçerse ikinciye sütun sırası eklenir.
+        const gorulen = new Set();
+        for (const s of kullanilan) {
+            const k = `${s.aracId}/${s.soruNo}`;
+            if (gorulen.has(k))
+                s.soruNo = `${s.soruNo}_${s.j + 1}`;
+            gorulen.add(`${s.aracId}/${s.soruNo}`);
+        }
+        const asim = [];
+        const puanlar = veri.flatMap((r) => kullanilan.map((s) => {
+            const p = puanOku(r[s.j] ?? "", ayirac);
+            if (p !== null && s.tamPuan !== null && p > s.tamPuan)
+                asim.push(`${r[0]}: "${s.baslik}" ${p} > ${s.tamPuan}`);
+            return { ogrenci: r[0] ?? "", aracId: s.aracId, soruNo: s.soruNo, puan: p };
+        }));
+        if (asim.length)
+            eksikler.push(`${asim.length} hücrede puan tam puanı aşıyor (ilk: ${asim[0]}). Tabloyu denetleyin.`);
+        const agirlikToplami = aracIdleri.reduce((t, id) => t + (agirliklar[id] ?? 0), 0);
+        if (aracIdleri.every((id) => agirliklar[id] !== undefined) && Math.abs(agirlikToplami - 100) > 0.001)
+            eksikler.push(`Ölçme aracı yüzdeleri toplamı ${agirlikToplami}; 100 olmalı (bütünleme hariç tutulabilir).`);
+        const araclar = aracIdleri.map((id) => {
+            const ss = kullanilan.filter((s) => s.aracId === id);
+            return {
+                id,
+                tur: ss[0]?.tur ?? "diger",
+                ad: ss[0]?.aracAdi ?? id,
+                agirlik: agirliklar[id] ?? null,
+                sorular: ss.map((s) => ({
+                    no: s.soruNo,
+                    tamPuan: s.tamPuan,
+                    eslemeler: s.ciktilar.map((c) => ({ ciktiKod: c, agirlik: 1 })),
+                })),
+            };
+        });
+        const ciktilar = [...new Set(kullanilan.flatMap((s) => s.ciktilar))].sort((a, b) => Number(a.slice(1)) - Number(b.slice(1)));
+        return {
+            sonuc: {
+                ogrenciSayisi: veri.length,
+                ayirac: ayirac === "\t" ? "sekme" : ayirac,
+                sutunlar: kullanilan.map(({ j: _j, ...s }) => s),
+                yoksayilanSutunlar: yoksayilan,
+                ciktilar,
+                eksikler,
+                hazir: eksikler.length === 0,
+                ckPcHesaplaTaslagi: {
+                    ciktilar: ciktilar.map((kod) => ({ kod })),
+                    araclar,
+                    puanlar,
+                    not: "dersKodu ve donem alanlarını hocadan alıp ekleyin. Eksik kalmayınca ck_pc_hesapla'ya verin.",
+                },
+                sutunEslemeRehberi: SUTUN_ESLEME_REHBERI,
+            },
+            kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/not-tablosu.ts", "Akredit not tablosu ayrıştırıcısı")],
+            ...(eksikler.length
+                ? {
+                    sonrakiAdim: "Eksikleri hocaya numaralı ve tek tek, seçenekle sorun; yanıtları tamPuanlar, eslemeler ve agirliklar olarak verip aracı yeniden çağırın. Tabloyu yeniden yapıştırtmayın, aynı tabloyu kullanın.",
+                }
+                : {}),
+        };
+    },
+});

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

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export interface AcikIstem {
+    ad: string;
+    baslik: string;
+    aciklama: string;
+    /** Bağımsız değişkenler: hepsi isteğe bağlı kısa metin. */
+    argumanlar: Record<string, string>;
+    metin: (a: Record<string, string | undefined>) => string;
+}
+/** Giriş bilgisi kuralı: bütün istemlerde aynen yer alır. */
+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;
+/** akredit başlangıcının sorduğu odak menüsü; site örnek konuşmayı buradan okur. */
+export declare const AKREDIT_ODAKLARI: readonly {
+    no: string;
+    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>>;