@akredit/acik-mcp 0.1.0 → 0.5.0

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

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export interface Adim {
+    no: number;
+    yap: string;
+    /** Adımdan sonra ekranda ne görüleceği. */
+    goreceginiz?: string;
+    /** Menü ya da düğme adı sürüme göre değişebilir, doğrulanmadı. */
+    degisebilir?: boolean;
+}
+/** Her rehberin başında hocaya söylenecek giriş kuralı. */
+export declare const GIRIS_KURALI_HOCAYA = "Kullan\u0131c\u0131 ad\u0131n\u0131z\u0131 ve parolan\u0131z\u0131 yaln\u0131z OBS'nin kendi giri\u015F ekran\u0131na, kendiniz yaz\u0131n. Bana, sohbete ya da Akredit'e asla yazmay\u0131n. Do\u011Frulama kodu (SMS, e-posta) ve CAPTCHA da yaln\u0131z sizindir.";
+export declare const MCP_ADRESI = "https://akredit.org/mcp";
+export declare const ISTEMCILER: readonly ["claude_web", "claude_masaustu", "claude_chrome", "chatgpt", "cursor", "vscode", "claude_code"];
+export type Istemci = (typeof ISTEMCILER)[number];
+/** Bağlayıcı ekleme adımları; site (akredit.org ana sayfası) aynı adımları buradan okur. */
+export declare function baglayiciAdimlari(istemci: Istemci): Adim[];
+export declare const ENGELLER: readonly ["tarayici_araci_yok", "site_acilmiyor", "giris_duvari", "captcha", "cerceve", "oturum_dustu", "sayfa_okunamiyor", "kaydet_basilamiyor", "akredit_gorunmuyor"];
+export type Engel = (typeof ENGELLER)[number];
+export declare const kurulumYardimiAraci: import("./temel.ts").AcikArac<z.ZodObject<{
+    istemci: z.ZodEnum<{
+        claude_web: "claude_web";
+        claude_masaustu: "claude_masaustu";
+        claude_chrome: "claude_chrome";
+        chatgpt: "chatgpt";
+        cursor: "cursor";
+        vscode: "vscode";
+        claude_code: "claude_code";
+    }>;
+    konu: z.ZodDefault<z.ZodEnum<{
+        baglayici: "baglayici";
+        hepsi: "hepsi";
+        tarayici: "tarayici";
+    }>>;
+}, z.core.$strip>>;
+export declare const engelCozAraci: import("./temel.ts").AcikArac<z.ZodObject<{
+    engel: z.ZodEnum<{
+        cerceve: "cerceve";
+        tarayici_araci_yok: "tarayici_araci_yok";
+        site_acilmiyor: "site_acilmiyor";
+        giris_duvari: "giris_duvari";
+        captcha: "captcha";
+        oturum_dustu: "oturum_dustu";
+        sayfa_okunamiyor: "sayfa_okunamiyor";
+        kaydet_basilamiyor: "kaydet_basilamiyor";
+        akredit_gorunmuyor: "akredit_gorunmuyor";
+    }>;
+    istemci: z.ZodOptional<z.ZodEnum<{
+        claude_web: "claude_web";
+        claude_masaustu: "claude_masaustu";
+        claude_chrome: "claude_chrome";
+        chatgpt: "chatgpt";
+        cursor: "cursor";
+        vscode: "vscode";
+        claude_code: "claude_code";
+    }>>;
+}, z.core.$strip>>;

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

@@ -0,0 +1,381 @@
+// Kurulum ve engel çözme rehberi. Metinler sabittir, model üretmez. Hocanın kendi OBS'sine tarayıcıyla girmesi
+// için adımlar verir. Değişmez kural: kullanıcı adı, parola ve doğrulama kodu yalnız OBS'nin kendi ekranına,
+// hocanın kendisi tarafından yazılır; asistana ve Akredit'e hiç yazılmaz. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e
+// hoca ya da hocanın açık izniyle asistan basar; onaya Gönder düğmesine hoca basar.
+//
+// Menü ve düğme adları istemcinin sürümüne göre değişir. Doğrulanmamış adlar `degisebilir: true` ile işaretlidir.
+import { z } from "zod";
+import { arac, KOD_KAYNAGI } from "./temel.js";
+const numarala = (xs) => xs.map(([yap, goreceginiz, degisebilir], i) => ({
+    no: i + 1,
+    yap,
+    ...(goreceginiz ? { goreceginiz } : {}),
+    ...(degisebilir ? { degisebilir: true } : {}),
+}));
+/** Her rehberin başında hocaya söylenecek giriş kuralı. */
+export const GIRIS_KURALI_HOCAYA = "Kullanıcı adınızı ve parolanızı yalnız OBS'nin kendi giriş ekranına, kendiniz yazın. Bana, sohbete ya da Akredit'e asla yazmayın. Doğrulama kodu (SMS, e-posta) ve CAPTCHA da yalnız sizindir.";
+export const MCP_ADRESI = "https://akredit.org/mcp";
+export const ISTEMCILER = [
+    "claude_web",
+    "claude_masaustu",
+    "claude_chrome",
+    "chatgpt",
+    "cursor",
+    "vscode",
+    "claude_code",
+];
+const ISTEMCI_ADI = {
+    claude_web: "Claude (claude.ai, web)",
+    claude_masaustu: "Claude masaüstü uygulaması",
+    claude_chrome: "Claude in Chrome (Chrome eklentisi)",
+    chatgpt: "ChatGPT",
+    cursor: "Cursor",
+    vscode: "VS Code",
+    claude_code: "Claude Code",
+};
+const BAGLAYICI = {
+    // Anthropic yardım belgesi "Get started with custom connectors using remote MCP" (erişim 2026-11-05).
+    claude_web: [
+        ["claude.ai adresine girin ve oturum açın.", "Sol tarafta sohbet listesi, ortada yazı kutusu."],
+        ["Customize (Özelleştir), ardından Connectors (Bağlayıcılar) bölümünü açın.", "Bağlı araçların listesi."],
+        ["+ Add düğmesine, ardından Add custom connector seçeneğine basın.", "Ad ve adres soran pencere."],
+        [`Ad olarak Akredit, adres olarak ${MCP_ADRESI} yazın ve Continue deyin.`, "Kimlik doğrulama seçenekleri."],
+        ["Authentication altında No sign in seçin ve Add deyin.", "Listede Akredit görünür."],
+        [
+            "Ücretsiz planda tek özel bağlayıcı eklenebilir. Team ve Enterprise planlarında bağlayıcıyı kuruluş sahibi ekler; siz Connectors listesinde Akredit'i bulup Connect dersiniz.",
+            undefined,
+        ],
+        [
+            "Yeni sohbet açın. Yazı kutusunun altındaki + düğmesinden Akredit'in açık olduğunu denetleyin.",
+            "Akredit'in yanında açık anahtar.",
+            true,
+        ],
+        [
+            "akredit yazın. Menü gelmezse Akredit araçlarıyla Bologna paketimi denetle yazın.",
+            "Odak menüsü: numaralı seçenekler.",
+        ],
+    ],
+    claude_masaustu: [
+        ["Claude masaüstü uygulamasını açın ve oturum açın.", "claude.ai ile aynı görünüm."],
+        ["Customize (Özelleştir), ardından Connectors (Bağlayıcılar) bölümünü açın.", "Bağlayıcı listesi."],
+        [
+            `+ Add, Add custom connector ile ad Akredit, adres ${MCP_ADRESI} yazın; Authentication altında No sign in seçip Add deyin.`,
+            "Listede Akredit görünür.",
+        ],
+        ["Yeni sohbette akredit yazın. Menü gelmezse Akredit araçlarıyla Bologna paketimi denetle yazın.", "Odak menüsü."],
+    ],
+    claude_chrome: [
+        ["Önce Claude'a Akredit bağlayıcısını ekleyin (Claude web adımları).", "Sohbette Akredit açık."],
+        [
+            "Chrome tarayıcısını açın. Chrome Web Mağazası'nda Claude eklentisini arayın (Claude in Chrome).",
+            "Eklentinin sayfası.",
+            true,
+        ],
+        ["Chrome'a ekle düğmesine basın, izin penceresinde onaylayın.", "Sağ üstte Claude simgesi.", true],
+        ["Yapboz simgesinden Claude'u sabitleyin (iğne simgesi).", "Claude simgesi araç çubuğunda kalır.", true],
+        ["Simgeye tıklayın, Claude hesabınızla oturum açın.", "Tarayıcının kenarında Claude paneli açılır.", true],
+        [
+            "OBS sayfanızı aynı pencerede açın; panelde akredit yazın.",
+            "Asistan OBS sayfasını okumak için izin ister; siz onaylarsınız.",
+        ],
+        [
+            "Eklenti bazı planlarda ya da kurum hesaplarında kapalı olabilir; o durumda kopyala-yapıştır yedeğini kullanın.",
+            undefined,
+            true,
+        ],
+    ],
+    // OpenAI geliştirici belgesi "Custom MCP server" (erişim 2026-11-05). Hangi planlarda açık olduğu belgede yazmıyor.
+    chatgpt: [
+        ["chatgpt.com adresinde, web tarayıcısında oturum açın.", "Sohbet ekranı."],
+        ["chatgpt.com/plugins adresini açın; + düğmesine basıp Add custom MCP server seçin.", "Ad ve bağlantı soran form."],
+        [
+            `Ad olarak Akredit yazın; Connection altında Server URL olarak ${MCP_ADRESI} girin; kimlik doğrulama olarak no authentication seçin.`,
+            undefined,
+            true,
+        ],
+        [
+            "Uyarıyı okuyup I understand and want to continue, ardından Create as a plugin deyin; sonra eklentiyi kurun.",
+            "Akredit eklentilerinizde görünür.",
+            true,
+        ],
+        [
+            "Bu özelliğin açık olup olmadığı planınıza göre değişebilir. Kurum hesabında çalışma alanı izinleri yöneticiye bağlıdır.",
+            undefined,
+            true,
+        ],
+        ["Yeni sohbette @ yazıp Akredit'i seçin, sonra akredit yazın.", "Odak menüsü."],
+    ],
+    cursor: [
+        ["Cursor'da Settings (Ayarlar), ardından MCP bölümünü açın.", "MCP sunucu listesi.", true],
+        [
+            `Add new MCP server ile ad akredit, adres ${MCP_ADRESI} girin. Ya da .cursor/mcp.json dosyasına ekleyin.`,
+            "Akredit yeşil noktayla görünür.",
+            true,
+        ],
+        ["Sohbet panelinde eğik çizgi (/) yazın ve akredit seçin.", "Odak menüsü."],
+    ],
+    vscode: [
+        ["Komut paletini açın (Ctrl+Shift+P, Mac'te Cmd+Shift+P).", "Üstte arama kutusu."],
+        ["MCP: Add Server yazıp seçin, HTTP türünü seçin.", "Adres soran kutu.", true],
+        [`Adres olarak ${MCP_ADRESI}, ad olarak akredit yazın.`, "Akredit sunucu listesinde."],
+        ["Copilot sohbetinde ajan (Agent) kipini seçin, eğik çizgiyle akredit komutunu çalıştırın.", "Odak menüsü.", true],
+    ],
+    claude_code: [
+        [
+            `Uçbirimde şunu çalıştırın: claude mcp add --transport http akredit ${MCP_ADRESI}`,
+            "Added HTTP MCP server iletisi.",
+        ],
+        ["claude komutuyla oturumu açın, /mcp ile Akredit'in bağlı olduğunu denetleyin.", "akredit: connected.", true],
+        ["Eğik çizgiyle akredit komutunu seçin.", "Odak menüsü."],
+    ],
+};
+/** Bağlayıcı ekleme adımları; site (akredit.org ana sayfası) aynı adımları buradan okur. */
+export function baglayiciAdimlari(istemci) {
+    return numarala(BAGLAYICI[istemci]);
+}
+const TARAYICI = {
+    claude_web: [
+        [
+            "claude.ai web sürümü kendi başına OBS'nize giremez. Tarayıcı için Claude in Chrome eklentisini ya da masaüstü uygulamasını kullanın.",
+            undefined,
+        ],
+        [
+            "Bunlar yoksa kopyala-yapıştır yedeği: OBS'de ders sayfasını açın, Ctrl+A ile hepsini seçin, Ctrl+C ile kopyalayın, sohbete Ctrl+V ile yapıştırın.",
+            "Asistan sayfayı ayrıştırır.",
+        ],
+    ],
+    claude_masaustu: [
+        [
+            "Masaüstü uygulamasında sohbetin yanında tarayıcı paneli açılabilir. Panelin düğmesi ya da menüsü sürüme göre değişir.",
+            "Sohbetin yanında küçük bir tarayıcı.",
+            true,
+        ],
+        ["Asistandan OBS adresinizi açmasını isteyin ya da adresi panele siz yazın.", "OBS giriş ekranı."],
+        [
+            "Kullanıcı adınızı ve parolanızı panelde OBS'nin kendi kutularına kendiniz yazın. Sohbete yazmayın.",
+            "OBS ana sayfası.",
+        ],
+        [
+            "Asistana 'girdim' yazın. Asistan ders listesini ve Bologna sayfasını okur.",
+            "Ders listesi sohbette numaralı görünür.",
+        ],
+    ],
+    claude_chrome: [
+        ["Chrome'da yeni sekmede OBS adresinizi açın.", "OBS giriş ekranı."],
+        [
+            "Kullanıcı adınızı ve parolanızı OBS'nin kendi kutularına kendiniz yazın; varsa doğrulama kodunu ve CAPTCHA'yı siz girin.",
+            "OBS ana sayfası.",
+        ],
+        [
+            "Claude simgesine tıklayıp paneli açın, 'OBS'ye girdim' yazın.",
+            "Asistan sayfayı okumak için izin isteyebilir; onaylayın.",
+            true,
+        ],
+        ["Asistan ders listesini okur, dersinizi numarasıyla seçersiniz.", "Ders bilgi paketi alanları."],
+        [
+            "Asistan formu doldurursa her alanı gözle denetleyin. Kaydet'e siz basarsınız; isterseniz açık izninizle asistan basar. Onaya Gönder düğmesine siz basarsınız.",
+            "OBS'nin kayıt iletisi.",
+        ],
+    ],
+    chatgpt: [
+        [
+            "Yazı kutusundaki Araçlar (Tools) menüsünden Ajan modunu (Agent mode) seçin.",
+            "ChatGPT kendi tarayıcısını açar.",
+            true,
+        ],
+        ["OBS adresinizi açmasını isteyin.", "OBS giriş ekranı ajanın tarayıcısında."],
+        [
+            "Giriş ekranında Devral (Take over) düğmesine basın; kullanıcı adı ve parolayı kendiniz yazın. Sohbete yazmayın.",
+            "OBS ana sayfası.",
+            true,
+        ],
+        ["Denetimi asistana geri verin.", "Asistan sayfayı okur."],
+        ["Kaydet'e siz basarsınız ya da açık izninizle asistan basar. Onaya Gönder düğmesine siz basarsınız.", undefined],
+    ],
+    cursor: [
+        ["Cursor'un tarayıcı aracı sürüme göre değişir. Varsa asistandan OBS adresini açmasını isteyin.", undefined, true],
+        ["Yoksa kopyala-yapıştır yedeği: sayfada Ctrl+A, Ctrl+C, sohbete Ctrl+V.", "Asistan sayfayı ayrıştırır."],
+    ],
+    vscode: [
+        ["VS Code'da OBS'ye tarayıcıyla girmek için ek araç gerekir; bu en zor yoldur.", undefined, true],
+        [
+            "En kolayı kopyala-yapıştır: tarayıcınızda OBS sayfasında Ctrl+A, Ctrl+C, sohbete Ctrl+V.",
+            "Asistan sayfayı ayrıştırır.",
+        ],
+    ],
+    claude_code: [
+        [
+            "Claude Code'da tarayıcı için Claude in Chrome eklentisi bağlanabilir; adımlar sürüme göre değişir.",
+            undefined,
+            true,
+        ],
+        ["Yoksa kopyala-yapıştır yedeği: sayfada Ctrl+A, Ctrl+C, uçbirime yapıştırın.", "Asistan sayfayı ayrıştırır."],
+    ],
+};
+export const ENGELLER = [
+    "tarayici_araci_yok",
+    "site_acilmiyor",
+    "giris_duvari",
+    "captcha",
+    "cerceve",
+    "oturum_dustu",
+    "sayfa_okunamiyor",
+    "kaydet_basilamiyor",
+    "akredit_gorunmuyor",
+];
+const KOPYALA_YAPISTIR = [
+    ["Yedek yol: OBS'de ders bilgi paketi sayfasını kendiniz açın.", "Ders sayfası."],
+    ["Sayfanın boş bir yerine tıklayın, Ctrl+A ile hepsini seçin (Mac'te Cmd+A).", "Sayfa mavi seçilir."],
+    ["Ctrl+C ile kopyalayın (Mac'te Cmd+C).", undefined],
+    [
+        "Sohbete dönüp Ctrl+V ile yapıştırın ve gönderin.",
+        "Asistan alanları ayrıştırıp bulunan ve bulunamayan alanları söyler.",
+    ],
+];
+const ENGEL_ADIMLARI = {
+    tarayici_araci_yok: {
+        ad: "Asistanın tarayıcı aracı yok",
+        adimlar: [
+            [
+                "Claude kullanıyorsanız Claude in Chrome eklentisini kurun (kurulum_yardimi, istemci: claude_chrome).",
+                undefined,
+            ],
+            ["Claude masaüstü uygulamasında sohbetin yanındaki tarayıcı panelini açmayı deneyin.", undefined, true],
+            ["ChatGPT'de Araçlar menüsünden Ajan modunu seçin.", undefined, true],
+        ],
+        yedek: true,
+    },
+    site_acilmiyor: {
+        ad: "OBS sitesi açılmıyor",
+        adimlar: [
+            ["Adresi kendi tarayıcınızda açıp deneyin. Açılıyorsa adresi asistana olduğu gibi verin.", undefined],
+            [
+                "Kurum dışından erişim kapalı olabilir (VPN ya da kampüs ağı). Kurumunuzun bilgi işlem sayfasına bakın.",
+                undefined,
+            ],
+            ["Site bakımda olabilir; birkaç dakika sonra yeniden deneyin.", undefined],
+        ],
+        yedek: true,
+    },
+    giris_duvari: {
+        ad: "Giriş ekranı",
+        adimlar: [
+            ["Bu normaldir. Kullanıcı adınızı ve parolanızı OBS'nin kendi kutularına kendiniz yazın.", "OBS ana sayfası."],
+            [
+                "Asistana yalnız 'girdim' yazın. Parolayı sohbete yazmayın; yazdıysanız silin ve parolanızı değiştirin.",
+                undefined,
+            ],
+            ["e-Devlet ya da kurum tek oturum açma ekranı gelirse onu da kendiniz tamamlayın.", undefined],
+        ],
+        yedek: false,
+    },
+    captcha: {
+        ad: "Ben robot değilim (CAPTCHA) kutusu",
+        adimlar: [
+            ["CAPTCHA'yı siz çözün; asistan çözmez.", undefined],
+            ["Çözdükten sonra asistana 'devam' yazın.", "Asistan kaldığı yerden sürer."],
+        ],
+        yedek: false,
+    },
+    cerceve: {
+        ad: "Sayfa çerçeve (iframe) içinde, asistan içeriği göremiyor",
+        adimlar: [
+            [
+                "Ders sayfasındaki bağlantıya sağ tıklayın, Bağlantıyı yeni sekmede aç seçin.",
+                "Sayfa tek başına açılır.",
+                true,
+            ],
+            ["Asistandan bu yeni sekmeyi okumasını isteyin.", undefined],
+        ],
+        yedek: true,
+    },
+    oturum_dustu: {
+        ad: "Oturum düştü ya da süre doldu",
+        adimlar: [
+            ["OBS'ye yeniden kendiniz girin (kullanıcı adı ve parolayı yalnız OBS ekranına).", "OBS ana sayfası."],
+            [
+                "Kaydedilmemiş alanlar silinmiş olabilir. Asistandan son seçilen metni yeniden istemek için 'kopya metnini ver' yazın.",
+                undefined,
+            ],
+            ["Uzun formlarda her sekmeyi doldurduktan sonra Kaydet'e basın.", undefined],
+        ],
+        yedek: false,
+    },
+    sayfa_okunamiyor: {
+        ad: "Asistan sayfayı okuyamıyor ya da alanları bulamıyor",
+        adimlar: [
+            ["Sayfanın tamamen yüklendiğini bekleyin ve asistandan yeniden okumasını isteyin.", undefined],
+            ["Bologna sayfasında dersin Ders Bilgileri sekmesinde olduğunuzu denetleyin.", undefined, true],
+        ],
+        yedek: true,
+    },
+    kaydet_basilamiyor: {
+        ad: "Kaydet ya da Gönder",
+        adimlar: [
+            [
+                "Kaydet'e siz basarsınız; isterseniz asistan sizin açık izninizle (evet ya da bir kez hepsini kaydet) basar. Onaya Gönder düğmesine yalnız siz basarsınız.",
+                undefined,
+            ],
+            ["Basmadan önce alanları gözle denetleyin.", undefined],
+            ["Düğme pasifse zorunlu bir alan boş olabilir; OBS'nin kırmızı uyarısına bakın ve asistana söyleyin.", undefined],
+        ],
+        yedek: false,
+    },
+    akredit_gorunmuyor: {
+        ad: "Akredit araçları ya da akredit komutu görünmüyor",
+        adimlar: [
+            ["Yeni bir sohbet açın; bağlayıcı eski sohbette görünmeyebilir.", undefined],
+            ["Yazı kutusunun altındaki + ya da araç menüsünden Akredit'in açık olduğunu denetleyin.", undefined, true],
+            ["Komut görünmüyorsa 'Akredit ile başlayalım' yazmanız yeter.", "Asistan odak menüsünü gösterir."],
+            [`Bağlayıcı adresinin tam olarak ${MCP_ADRESI} olduğunu denetleyin.`, undefined],
+        ],
+        yedek: false,
+    },
+};
+export const kurulumYardimiAraci = arac({
+    ad: "kurulum_yardimi",
+    baslik: "Kurulum yardımı",
+    aciklama: "Akredit bağlayıcısını eklemek ve OBS'ye tarayıcıyla girmek için istemciye göre adım adım rehber verir: Claude web ve masaüstü, Claude in Chrome, ChatGPT, Cursor, VS Code, Claude Code. Her adımda ekranda ne görüleceğini söyler.",
+    sonrakiAdim: "Adımları hocaya tek tek gösterin: bir adım verin, 'oldu' demesini bekleyin, sonra sıradakine geçin. 'değişebilir' işaretli menü adını 'sizde biraz farklı olabilir' diye söyleyin. Giriş kuralını hocaya bir kez açıkça söyleyin.",
+    girdi: z.object({
+        istemci: z.enum(ISTEMCILER).describe("Hocanın kullandığı asistan"),
+        konu: z
+            .enum(["baglayici", "tarayici", "hepsi"])
+            .default("hepsi")
+            .describe("Bağlayıcı ekleme, OBS'ye tarayıcıyla giriş ya da ikisi"),
+    }),
+    calistir: ({ istemci, konu }) => ({
+        sonuc: {
+            istemci: ISTEMCI_ADI[istemci],
+            girisKurali: GIRIS_KURALI_HOCAYA,
+            ...(konu !== "tarayici" ? { baglayiciAdimlari: numarala(BAGLAYICI[istemci]) } : {}),
+            ...(konu !== "baglayici" ? { tarayiciAdimlari: numarala(TARAYICI[istemci]) } : {}),
+            not: "Menü adları istemcinin sürümüne ve diline göre değişebilir. 'degisebilir' işaretli adlar doğrulanmadı.",
+        },
+        kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit kurulum rehberi")],
+    }),
+});
+export const engelCozAraci = arac({
+    ad: "engel_coz",
+    baslik: "Engel çöz",
+    aciklama: "OBS'ye girerken ya da sayfayı okurken çıkan engel için numaralı çözüm adımları verir: tarayıcı aracı yok, site açılmıyor, giriş ekranı, CAPTCHA, çerçeve, oturum düşmesi, sayfa okunamıyor, Kaydet düğmesi, Akredit görünmüyor. Gerekirse kopyala-yapıştır yedeğini de verir.",
+    sonrakiAdim: "Adımları hocaya tek tek gösterin. Hiçbiri olmazsa kopyala-yapıştır yedeğine geçin. Parola, doğrulama kodu ya da çerez istemeyin.",
+    girdi: z.object({
+        engel: z.enum(ENGELLER),
+        istemci: z.enum(ISTEMCILER).optional(),
+    }),
+    calistir: ({ engel, istemci }) => {
+        const e = ENGEL_ADIMLARI[engel];
+        const ozel = engel === "tarayici_araci_yok" && istemci ? TARAYICI[istemci] : [];
+        return {
+            sonuc: {
+                engel: e.ad,
+                girisKurali: GIRIS_KURALI_HOCAYA,
+                adimlar: numarala([...ozel, ...e.adimlar]),
+                ...(e.yedek ? { yedekYol: numarala(KOPYALA_YAPISTIR) } : {}),
+                obsyeYazmaYedegi: "Tarayıcı aracı yoksa asistan bologna_kopya_metni ile alan alan kopyalanacak metni verir; siz OBS'de ilgili kutuya yapıştırıp Kaydet'e basarsınız.",
+            },
+            kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit engel çözme rehberi")],
+        };
+    },
+});

package/dist/packages/baglayicilar/src/bologna-proliz/ayristir.d.ts

@@ -0,0 +1,29 @@
+import type { BolognaDersSayfasi, BolognaProgramCiktisi, BolognaProgramMatrisi } from "../../../cekirdek/src/index.js";
+/** HTML parçasını düz metne çevirir. */
+export declare function metin(html: string): string;
+export type HtmlTablosu = string[][];
+/** Sayfadaki en içteki tabloları satır ve hücre dizisine çevirir. */
+export declare function tablolar(html: string): HtmlTablosu[];
+/** Metindeki ilk sayıyı alır ("% 40" → 40, "2,5" → 2.5). */
+export declare const sayi: (s: unknown) => number | null;
+export interface BolognaAdresi {
+    taban: string;
+    sunit: string;
+    dil: string;
+}
+/** Program adresinden taban adresi ve program kimliğini çıkarır. */
+export declare function adresCoz(adres: string): BolognaAdresi;
+export declare function programCiktilari(html: string): BolognaProgramCiktisi[];
+export declare const EPOSTA_YERINE = "[e-posta ay\u0131kland\u0131]";
+/** Nesnedeki bütün metinlerden e-posta adreslerini ayıklar. */
+export declare function epostaAyikla<T>(x: T): T;
+export declare function programMatrisi(html: string): BolognaProgramMatrisi;
+/** Ders listesi sayfasından ders kodu → Proliz ders kimliği eşlemesi. */
+export declare function dersKimlikleri(html: string): Record<string, string>;
+/** Bir ders bilgi sayfasını ayrıştırır. E-posta adresleri çıktıdan ayıklanır (KVKK: en az kişisel veri). */
+export declare function dersSayfasiCoz(html: string): BolognaDersSayfasi;
+/**
+ * TYYÇ matrisinde program çıktısı sütunlarındaki dolu hücreleri sayar.
+ * Satırlar "etiket, alt no, P1..Pn, alt no, etiket" ya da etiketsiz "alt no, P1..Pn, alt no" biçimindedir.
+ */
+export declare function tyycIsaretSayisi(html: string, pSayisi: number): number | null;

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

@@ -0,0 +1,200 @@
+// Bologna Bilgi Paketi (Proliz OBS) sayfa ayrıştırıcıları.
+// apps/cli/lib/bologna.mjs içindeki işlevlerin davranışı birebir korunarak TypeScript'e taşınmış hâlidir.
+const VARLIKLAR = { nbsp: " ", amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+const ETIKET = /<(?:[^>"']|"[^"]*"|'[^']*')*>/g;
+const BETIK = /<(script|style)\b(?:[^>"']|"[^"]*"|'[^']*')*>[\s\S]*?<\/\1>/gi;
+/** HTML parçasını düz metne çevirir. */
+export function metin(html) {
+    return html
+        .replace(BETIK, "")
+        .replace(/<br\s*\/?>/gi, " ")
+        .replace(ETIKET, " ")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
+        .replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(Number.parseInt(n, 16)))
+        .replace(/&([a-z]+);/gi, (m, a) => VARLIKLAR[a.toLowerCase()] ?? m)
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Sayfadaki en içteki tabloları satır ve hücre dizisine çevirir. */
+export function tablolar(html) {
+    const temiz = html.replace(BETIK, "");
+    const sonuc = [];
+    const re = /<table\b(?:[^>"']|"[^"]*"|'[^']*')*>((?:(?!<table\b)[\s\S])*?)<\/table>/gi;
+    for (let m = re.exec(temiz); m; m = re.exec(temiz)) {
+        const satirlar = [...(m[1] ?? "").matchAll(/<tr\b(?:[^>"']|"[^"]*"|'[^']*')*>([\s\S]*?)<\/tr>/gi)].map((r) => [...(r[1] ?? "").matchAll(/<t[dh]\b(?:[^>"']|"[^"]*"|'[^']*')*>([\s\S]*?)<\/t[dh]>/gi)].map((c) => metin(c[1] ?? "")));
+        if (satirlar.some((s) => s.length))
+            sonuc.push(satirlar);
+    }
+    return sonuc;
+}
+/** Metindeki ilk sayıyı alır ("% 40" → 40, "2,5" → 2.5). */
+export const sayi = (s) => {
+    const m = String(s ?? "")
+        .replace(",", ".")
+        .match(/-?\d+(\.\d+)?/);
+    return m ? Number(m[0]) : null;
+};
+/** Program adresinden taban adresi ve program kimliğini çıkarır. */
+export function adresCoz(adres) {
+    const u = new URL(adres);
+    const sunit = u.searchParams.get("curSunit");
+    const i = u.pathname.toLowerCase().indexOf("/bologna/");
+    if (!sunit || i < 0)
+        throw new Error("Bologna program adresi bekleniyor (içinde /bologna/ ve curSunit olmalı).");
+    return { taban: `${u.origin}${u.pathname.slice(0, i + 9)}`, sunit, dil: u.searchParams.get("lang") || "tr" };
+}
+export function programCiktilari(html) {
+    const t = tablolar(html).find((t) => /Program Öğrenme Çıktıları|Program Outcomes/i.test(t[0]?.join(" ") ?? ""));
+    if (!t)
+        return [];
+    return t
+        .slice(1)
+        .filter((r) => r.length >= 2 && sayi(r[0]) !== null)
+        .map((r) => ({ kod: `P${sayi(r[0])}`, metin: r[1] ?? "" }));
+}
+/** Ders kodu: harf önekli ("HUK101", "HUK 101") ya da sayısal ("1000.020105", EBYÜ canlı yapısı). */
+const DERS_KODU = /^(?:[A-ZÇĞİÖŞÜ]{2,}\s*\d|\d{3,}\.\d{3,})/;
+const DERS_KODU_ARA = /\b([A-ZÇĞİÖŞÜ]{2,}\s?\d{3}[A-Z]?|\d{3,}\.\d{3,})\b/;
+const YUZDE = /^%\s*\d/;
+const EPOSTA = /[\p{L}\d._%+-]+@[\p{L}\d-]+(?:\.[\p{L}\d-]+)+/gu;
+export const EPOSTA_YERINE = "[e-posta ayıklandı]";
+/** Nesnedeki bütün metinlerden e-posta adreslerini ayıklar. */
+export function epostaAyikla(x) {
+    if (typeof x === "string")
+        return x.replace(EPOSTA, EPOSTA_YERINE);
+    if (Array.isArray(x))
+        return x.map(epostaAyikla);
+    if (x && typeof x === "object")
+        return Object.fromEntries(Object.entries(x).map(([k, v]) => [k, epostaAyikla(v)]));
+    return x;
+}
+export function programMatrisi(html) {
+    const satirlar = tablolar(html).flat();
+    const baslik = satirlar.find((r) => r.includes("Ders Kodu") && r.some((h) => /^P\d+$/.test(h)));
+    if (!baslik)
+        return { pkodlar: [], dersler: [] };
+    const pBas = baslik.findIndex((h) => /^P\d+$/.test(h));
+    const pkodlar = baslik.slice(pBas);
+    let yariyil = null;
+    const dersler = [];
+    for (const r of satirlar) {
+        const ilk = r[0] ?? "";
+        if (r.length === 1 && /Yarıyıl|Semester/i.test(ilk)) {
+            yariyil = sayi(ilk);
+            continue;
+        }
+        if (r.length < pBas + 1 || r === baslik || ilk === "Ders Kodu")
+            continue;
+        const kod = ilk.replace(/^\[G\]\s*/, "");
+        if (!DERS_KODU.test(kod))
+            continue;
+        dersler.push({
+            kod,
+            ad: r[1] ?? "",
+            zorunlu: /Zorunlu|Compulsory/i.test(r[2] ?? ""),
+            grup: r[3] || null,
+            yariyil,
+            grupBasligi: ilk.startsWith("[G]"),
+            degerler: Object.fromEntries(pkodlar.map((p, i) => [p, r[pBas + i] ?? ""])),
+        });
+    }
+    return { pkodlar, dersler };
+}
+/** Ders listesi sayfasından ders kodu → Proliz ders kimliği eşlemesi. */
+export function dersKimlikleri(html) {
+    const kimlik = {};
+    for (const tr of html.split(/<tr\b/i).slice(1)) {
+        const id = tr.match(/prolizOpenCourseDetails\('?(\d+)/);
+        const kod = metin(tr).match(DERS_KODU_ARA);
+        if (id?.[1] && kod?.[1] && !kimlik[kod[1]])
+            kimlik[kod[1]] = id[1];
+    }
+    return kimlik;
+}
+/** Ders sayfasının ham ayrıştırması (e-posta ayıklanmadan). */
+function dersSayfasiCozHam(html) {
+    const t = tablolar(html);
+    const bul = (re) => t.find((x) => re.test((x[0] ?? []).join(" ")));
+    const ust = bul(/Yarıyıl.*Kodu|Semester.*Code/i);
+    const [yariyil, kod, ad, tul, kredi, akts, guncelleme] = ust?.[1] ?? [];
+    const bilgiler = Object.fromEntries((bul(/Dersin Dili|Language/i) ?? []).filter((r) => r.length >= 2).map((r) => [r[0] ?? "", r[1] ?? ""]));
+    const degerlendirme = (bul(/Yarıyıl Çalışmaları|Term Studies/i) ?? [])
+        .slice(1)
+        .filter((r) => r.length >= 3 && !/Toplam|Total/i.test(r[0] ?? ""))
+        .map((r) => ({ ad: r[0] ?? "", sayi: sayi(r[1]), katki: sayi(r[2]) }));
+    const isyukuTablosu = bul(/İş Yükü|Workload/i) ?? [];
+    const isyuku = isyukuTablosu
+        .slice(1)
+        .filter((r) => r.length >= 4 && sayi(r[3]) !== null && !/Toplam|Total|AKTS|ECTS/i.test(r[0] ?? ""))
+        .map((r) => ({ ad: r[0] ?? "", sayi: sayi(r[1]), sure: sayi(r[2]), toplam: sayi(r[3]) }));
+    // Canlı Proliz sayfasında (EBYÜ, 2026-10-27) alan yüzdesi tablosu başlıksızdır: ["Sosyal Bilimler", "%100", ""].
+    const dersYapisi = (t.find((x) => x.some((r) => /Alan Bilgisi|Field/i.test(r[0] ?? ""))) ??
+        t.find((x) => x.length > 0 && x.every((r) => r.length >= 2 && YUZDE.test(r[1] ?? ""))) ??
+        [])
+        .filter((r) => r.length >= 2 && /%/.test(r[1] ?? ""))
+        .map((r) => ({ alan: r[0] ?? "", yuzde: sayi(r[1]) }));
+    const ciktiTablosu = bul(/Sıra No|No.*A[cç]ıklama|Description/i) ?? [];
+    const ciktilar = ciktiTablosu
+        .slice(1)
+        .filter((r) => r.length >= 2 && sayi(r[0]) !== null && r[1])
+        .map((r) => ({ kod: `Ö${sayi(r[0])}`, metin: r[1] ?? "" }));
+    const haftalar = (bul(/Hafta|Week/i) ?? []).slice(1).filter((r) => sayi(r[0]) !== null && r[1]).length;
+    // Katkı satırları "Ö3" ya da çıktının türüne göre "Bi3" (bilgi), "Be3" (beceri), "Ye3" (yetkinlik) diye adlandırılır.
+    const katkiTablosu = t.find((x) => (x[0] ?? []).some((h) => /^P\d+$/.test(h)) &&
+        x.some((r) => /^(Tüm|All|Ö\d+|Bi\d+|Be\d+|Ye\d+)$/.test(r[0] ?? "")));
+    const katki = {};
+    if (katkiTablosu) {
+        const pk = (katkiTablosu[0] ?? []).slice(1);
+        for (const r of katkiTablosu.slice(1)) {
+            if (!r[0])
+                continue;
+            const ad = /^(Ö|Bi|Be|Ye)\d+$/.test(r[0]) ? `Ö${sayi(r[0])}` : r[0];
+            katki[ad] = Object.fromEntries(pk.map((p, i) => [p, r[i + 1] ?? ""]));
+        }
+    }
+    return {
+        yariyil: sayi(yariyil),
+        ...(kod !== undefined ? { kod } : {}),
+        ...(ad !== undefined ? { ad } : {}),
+        ...(tul !== undefined ? { tul } : {}),
+        kredi: sayi(kredi),
+        akts: sayi(akts),
+        ...(guncelleme !== undefined ? { guncelleme } : {}),
+        bilgiler,
+        degerlendirme,
+        isyuku,
+        dersYapisi,
+        ciktilar,
+        haftalar,
+        katki,
+    };
+}
+/** Bir ders bilgi sayfasını ayrıştırır. E-posta adresleri çıktıdan ayıklanır (KVKK: en az kişisel veri). */
+export function dersSayfasiCoz(html) {
+    return epostaAyikla(dersSayfasiCozHam(html));
+}
+/**
+ * TYYÇ matrisinde program çıktısı sütunlarındaki dolu hücreleri sayar.
+ * Satırlar "etiket, alt no, P1..Pn, alt no, etiket" ya da etiketsiz "alt no, P1..Pn, alt no" biçimindedir.
+ */
+export function tyycIsaretSayisi(html, pSayisi) {
+    if (!pSayisi)
+        return null;
+    // Canlı yapı (EBYÜ, 2026-10-27): 14 hücreli satır "alan, alt no, P1..Pn, alt no, alan"; rowspan yüzünden
+    // sonraki satırlar 12 hücreli "alt no, P1..Pn, alt no". Ayırıcı boş satırlar (alt no yok) sayılmaz.
+    // Hiç P hücresi okunamadıysa null (veri yok), okunup hepsi boşsa 0 döner.
+    let dolu = 0;
+    let okunan = 0;
+    for (const r of tablolar(html).flat()) {
+        const ic = r.length === pSayisi + 4 && /^\d+$/.test(r[1] ?? "")
+            ? r.slice(2, 2 + pSayisi)
+            : r.length === pSayisi + 2 && /^\d+$/.test(r[0] ?? "")
+                ? r.slice(1, 1 + pSayisi)
+                : null;
+        if (!ic)
+            continue;
+        okunan += ic.length;
+        dolu += ic.filter((h) => h && h !== "-").length;
+    }
+    return okunan ? dolu : null;
+}