@akredit/acik-mcp 0.4.0 → 0.6.0

package/README.md

@@ -62,7 +62,7 @@ Sunucu model çağırmaz ve metin üretmez. Bologna seçeneklerini sizin asistan
 
 ```
 Hoca:     akredit
-Asistan:  Bugün neye odaklanalım? 1) Bologna paketi 2) Öğrenme çıktısı 3) ÇK/PÇ 4) Ölçüt rehberi 5) Dil denetimi
+Asistan:  Neye odaklanalım? 1) Bologna paketi 2) Öğrenme çıktısı 3) ÇK/PÇ 4) Ölçüt rehberi 5) Dil denetimi
 Hoca:     1
 Asistan:  Önce bir kural: kullanıcı adınızı ve parolanızı yalnız OBS'nin kendi ekranına, kendiniz yazın.
           Bana asla yazmayın. OBS adresiniz nedir?
@@ -96,13 +96,13 @@ Asistan:  Sayfayı yeniden okudum ve denetledim: Tamamlandı.
 
 - Bütün araçlar salt okumadır ve aynı girdiye aynı sonucu verir.
 - Hesap ve anahtar gerekmez. Kurum verisine erişmez, hiçbir yere yazmaz, yapay zekâ modeli çağırmaz.
-- Giriş bilgisi hiç girmez: parola, doğrulama kodu ya da oturum çerezi görülürse çağrı reddedilir, değer yanıta yazılmaz. İstemler asistana hocadan giriş bilgisi istemeyi yasaklar. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e hoca basar ya da hocanın açık izniyle asistan basar; onaya gönderimi hoca yapar.
+- Giriş bilgisi istenmez: parola, doğrulama kodu ya da oturum çerezi görülürse çağrı reddedilir, değer kaydedilmez ve yanıta yazılmaz. İstemler asistana hocadan giriş bilgisi istemeyi yasaklar. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e hoca basar ya da hocanın açık izniyle asistan basar; onaya gönderimi hoca yapar.
 - Ölçüt metinleri resmî belgeden alınmıştır. Her yanıt kaynağını (belge adresi, sayfa, SHA-256) taşır. Belgeden alınamayan metin DOĞRULANMADI olarak döner.
 - Sayılar yalnız hesaptan gelir; araçlar metin uydurmaz.
-- Bologna sayfasındaki Dersi Verenler, Dersin Yardımcıları ve Koordinatör satırları hocanın kendi sayfasında yayımlanmış görev bilgisidir: olduğu gibi okunur, korunur ve OBS'ye geri yazılırken değiştirilmez. Bologna araçlarında yalnız giriş bilgisi reddedilir.
-- Öğrenci verisi takma adla işlenir: `not_tablosu_ayristir` ad, soyad ve numara sütunlarını hesaplamadan önce bellekte atar ve o1, o2 takma adı verir; not tablosu ve ÇK/PÇ araçlarında kalan ad ya da numara reddedilir. Öbür araçlarda T.C. kimlik numarası, öğrenci numarası ve IBAN reddedilir.
+- Bologna sayfasındaki Dersi Verenler, Dersin Yardımcıları ve Koordinatör satırları hocanın kendi sayfasında yayımlanmış görev bilgisidir: olduğu gibi okunur, korunur ve OBS'ye geri yazılırken değiştirilmez. Bologna araçlarında giriş bilgisi, T.C. kimlik numarası, öğrenci numarası ve IBAN reddedilir; yayımlanmış öğretim elemanı adları serbesttir.
+- Öğrenci verisi sohbete yapıştırılmaz: tablo sohbete yapıştırıldığı anda yapay zekâ sağlayıcısına gitmiştir. `not_tablosu_ayristir` ad, soyad ya da numara sütunu ya da 9-11 haneli numara görürse tabloyu işlemez; hocadan bu sütunları Excel'de silmesini ya da verinin tarayıcıdan çıkmadığı https://akredit.org/deneyin hesaplayıcısını kullanmasını ister. Öbür araçlarda T.C. kimlik numarası, öğrenci numarası ve IBAN reddedilir.
 - Sunucu istek içeriğini günlüğe yazmaz.
-- Kaynakçadaki yazar adları yayımlanmış künyedir; kaynak alanlarında serbesttir. Kaynak uydurulmaz: asistan web aramasıyla aday bulur, her adayı `kaynak_dogrula` ile katalogda doğrular ve yalnız doğrulananı bağlantısıyla önerir.
+- Kaynakçadaki yazar adları yayımlanmış künyedir; kaynak alanlarında serbesttir. Kaynak uydurulmaz: asistan web aramasıyla aday bulur, her adayı `kaynak_dogrula` ile katalogda arar ve yalnız katalogda bulunanı bağlantısıyla öneri olarak gösterir; uygunluğa hoca karar verir. Katalogda olmayan eser yalnız hoca beyanıyla yazılır. Bologna araçları düz metin ya da imzasız kaynağı doğrulanmamış sayar ve OBS yazma paketine almaz.
 - Sunucu kullanıcıdan adres almaz. Bologna sayfasını siz yapıştırırsınız ya da asistanınız kendi tarayıcı veya web aracıyla okur.
 - Dış istek: `kaynak_dogrula` yalnız api.crossref.org, openlibrary.org ve www.googleapis.com (Books) adreslerine sorar; sunucuyu kendiniz barındırıyorsanız bu üç adrese HTTPS çıkışı açık olmalıdır. Bağladığınız yapay zekâ hizmeti girdiyi kendi koşullarıyla işler.
 

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

@@ -10,6 +10,7 @@ import { BOLOGNA_ARACLARI, bolognaDenetleAraci } from "./bologna.js";
 import { kaynakBicimleAraci } from "./kaynak.js";
 import { kaynakDogrulaAraci } from "./kaynak-dogrula.js";
 import { notTablosuAyristirAraci } from "./not-tablosu.js";
+import { akreditBaslaAraci } from "./promptlar.js";
 import { AracHatasi, arac, DEPO, KOD_KAYNAGI } from "./temel.js";
 import { engelCozAraci, kurulumYardimiAraci } from "./yardim.js";
 export * from "./temel.js";
@@ -91,7 +92,7 @@ const olcutAra = arac({
     ad: "olcut_ara",
     baslik: "Ölçüt ara (YÖKAK ve program akreditasyonu)",
     aciklama: "YÖKAK ya da program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçütlerinde sözcük ya da kodla arar. Metinler resmî belgeden alınır; alınamayan metin DOĞRULANMADI döner.",
-    sonrakiAdim: "Hocaya en uygun 2-3 sonucu numaralı gösterin; seçtiği ölçütün tam metni için olcut_getir'i çağırın.",
+    sonrakiAdim: "Hocaya hangi ölçütü getireceğinizi sormayın: en uygun 1-2 sonuç için hemen olcut_getir'i (YÖKAK alt ölçütüyse olgunluk_duzeyleri'ni de) çağırıp yanıtı tek seferde hazırlayın. Diğer adayları sonda tek satırda anın.",
     girdi: z.object({
         sorgu: z.string().trim().min(1).max(200).describe("Aranacak ifade ya da kod, ör. 'paydaş katılımı' ya da 'B.3'"),
         cerceve: cerceveGirdisi,
@@ -172,7 +173,7 @@ const olcutGetir = arac({
     ad: "olcut_getir",
     baslik: "Ölçütü getir (YÖKAK ve program akreditasyonu)",
     aciklama: "Bir ölçütün resmî metnini kaynak belge, sayfa ve dosya özetiyle getirir; üst ve alt ölçütler, EPDAD göstergeleri, MÜDEK ve FEDEK programa özgü bölümleri de gelir. Metin tahminle doldurulmaz.",
-    sonrakiAdim: "Alt ölçütse olgunluk_duzeyleri ile düzeyleri ve örnek kanıtları gösterin. Hocaya sorun: 1) örnek kanıtlar 2) başka ölçüt 3) öz değerlendirme iskeleti.",
+    sonrakiAdim: "Alt ölçütse sormadan olgunluk_duzeyleri'ni çağırın. Resmî metni, düzeyleri ve kanıt kontrol listesini tek mesajda gösterin; sonda kısa bir satırla başka ölçüt ya da öz değerlendirme iskeleti önerin.",
     girdi: z.object({
         kod: z
             .string()
@@ -237,7 +238,7 @@ const olgunlukDuzeyleri = arac({
     ad: "olgunluk_duzeyleri",
     baslik: "Alt ölçüt olgunluk düzeyleri ve örnek kanıtlar",
     aciklama: "Bir YÖKAK alt ölçütünün (ör. B.1.2) 1-5 olgunluk düzeyi metinlerini ve örnek kanıtlarını getirir. Düzey önermez; düzeye kurum kanıtla karar verir.",
-    sonrakiAdim: "Örnek kanıtları hocanın elindekilerle eşleştirin: her kanıt için 1) var 2) yok 3) emin değilim diye sorun. Yok olanlar EKSİK kalır.",
+    sonrakiAdim: "Kanıtları hocaya tek tek sormayın. Resmî metni, 1-5 düzeylerini ve '[ ] kanıt (durum: hocaya sorulacak)' biçiminde kopyalanabilir kontrol listesini tek mesajda gösterin. Kurumda olup olmadığını tahmin etmeyin.",
     girdi: z.object({ kod: z.string().trim().min(1).max(20).describe("Alt ölçüt kodu, ör. 'B.1.2'") }),
     calistir: ({ kod }) => {
         const CERCEVE = YOKAK_KURUMSAL_3_3;
@@ -319,7 +320,7 @@ const ckPcHesapla = arac({
     kisiselVeriKapsami: "tam",
     baslik: "ÇK ve PÇ sağlanma düzeyi hesabı",
     aciklama: "Takma adlı puan tablosundan ders öğrenme çıktısı (ÇK) başarısını ve program çıktısı (PÇ) sağlanma düzeyini hesaplar. Öğrenci adı ve numarası kabul edilmez; yalnız toplu sonuç döner.",
-    sonrakiAdim: "Sonucu tablo olarak gösterin, sayıları yalnız bu yanıttan alın. Eşiğin altında kalan çıktılar için hocaya sorun: 1) iyileştirme notu yaz 2) başka eşikle yeniden hesapla 3) bitir.",
+    sonrakiAdim: "Sonucu tablo olarak gösterin, sayıları yalnız bu yanıttan alın. Eşiğin altında kalan çıktılar için aynı mesajda kısa iyileştirme notu taslağı verin (sayı uydurmadan); ayrıca soru sormayın.",
     girdi: z.object({
         dersKodu: kimlik,
         donem: z.string().trim().min(1).max(40).describe("ör. '2025-2026 Güz'"),
@@ -418,7 +419,7 @@ const raporDilDenetle = arac({
     ad: "rapor_dil_denetle",
     baslik: "Rapor dil denetimi",
     aciklama: "Rapor metnindeki dil sorunlarını işaretler: kanıtsız üstünlük, ölçüsüz nicelik, öznesiz eylem, dönem ve tarih tutarsızlığı. Metni değiştirmez.",
-    sonrakiAdim: "Her bulgu için 2-3 numaralı düzeltme seçeneği sunun (uydurma sayı ya da kanıt eklemeden); hoca seçince düzeltilmiş metni yeniden denetleyin.",
+    sonrakiAdim: "Bulguları hocaya tek tek sormayın. Hepsini kendiniz düzeltin (kanıt ya da sayı gereken yere uydurmadan [EKSİK: ...] yazın), düzeltilmiş metni yeniden rapor_dil_denetle ile denetleyin ve tek mesajda numaralı eski → yeni tablosunu ve düzeltilmiş tam metni verin.",
     girdi: z.object({
         metin: z.string().min(1).max(60_000),
         donem: z
@@ -445,6 +446,7 @@ const raporDilDenetle = arac({
     },
 });
 export const ACIK_ARACLAR = [
+    akreditBaslaAraci,
     olcutAra,
     olcutGetir,
     olgunlukDuzeyleri,

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

@@ -23,6 +23,19 @@ export declare const BLOOM_FIILLERI: {
 }[];
 /** Bir taslak bulgusunun hangi alana ait olduğu. "genel" birden çok alana değen bulgudur. */
 export declare function bulguAlani(b: Bulgu): AlanKodu | "temel" | "genel";
+declare const KaynakOgesi: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    kunye: z.ZodString;
+    dogrulama: z.ZodUnion<readonly [z.ZodLiteral<"hoca_beyani">, z.ZodObject<{
+        durum: z.ZodString;
+        baglanti: z.ZodString;
+        imza: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>;
+}, z.core.$strip>]>;
+export type KaynakOgesiT = z.infer<typeof KaynakOgesi>;
+export type KaynakDurumu = "katalogda_bulundu" | "hoca_beyani" | "dogrulanmamis";
+/** Kaynağın doğrulama durumu. Düz metin ya da imzası bu sürece ait olmayan kayıt doğrulanmamıştır. */
+export declare function kaynakDurumu(k: KaynakOgesiT): KaynakDurumu;
+export declare const kunyeMetni: (k: KaynakOgesiT) => string;
 declare const TaslakAlanlari: z.ZodObject<{
     amac: z.ZodOptional<z.ZodObject<{
         tr: z.ZodString;
@@ -76,7 +89,19 @@ declare const TaslakAlanlari: z.ZodObject<{
     }, z.core.$strip>>>;
     katki: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodNull, z.ZodLiteral<"">]>>>>;
     ska: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-    kaynaklar: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    degerlendirmeDayanagi: z.ZodOptional<z.ZodEnum<{
+        sayfa: "sayfa";
+        oneri: "oneri";
+        hoca: "hoca";
+    }>>;
+    kaynaklar: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        kunye: z.ZodString;
+        dogrulama: z.ZodUnion<readonly [z.ZodLiteral<"hoca_beyani">, z.ZodObject<{
+            durum: z.ZodString;
+            baglanti: z.ZodString;
+            imza: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>]>>>;
     kaynakSayisi: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type TaslakAlanlariT = z.infer<typeof TaslakAlanlari>;
@@ -91,7 +116,8 @@ declare const DersTemeli: z.ZodObject<{
     ad: z.ZodOptional<z.ZodString>;
     akts: z.ZodOptional<z.ZodNumber>;
     tul: z.ZodOptional<z.ZodString>;
-    bolen: z.ZodDefault<z.ZodNumber>;
+    bolen: z.ZodOptional<z.ZodNumber>;
+    donem: z.ZodOptional<z.ZodString>;
     yetkililer: z.ZodOptional<z.ZodArray<z.ZodObject<{
         rol: z.ZodString;
         deger: z.ZodString;
@@ -114,6 +140,8 @@ export declare function bolognaHesabi(ders: DersTemeliT, alanlar: TaslakAlanlari
         }[];
         toplam: number;
         hedef: number | null;
+        hedefAraligi: [number, number] | null;
+        aralikta: boolean | null;
         fark: number | null;
         aktsBasinaSaat: number | null;
         dersSuresiHaftalikBeklenen: number | null;
@@ -173,6 +201,7 @@ export declare const bolognaDenetleAraci: AcikArac<z.ZodObject<{
     }, z.core.$strip>>>;
     matrisSatiri: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     aktsSaat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    kurumBoleni: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
 /** Proliz sayfası mı: üst bilgi tablosu ("Yarıyıl, Kodu") ya da program çıktıları tablosu. */
 export declare function prolizMi(html: string): boolean;
@@ -191,19 +220,72 @@ export declare function ayristirOnAyikla(g: unknown): {
     atilan: string[];
     ileti?: string;
 };
-/** Hedefe tam eşit iş yükü dağılımları (deterministik). Son tek satır artığı alır, böylece toplam tam tutar. */
-export declare function isYukuDagilimlari(akts: number, tul: string, hafta?: number, bolen?: number): {
+export interface DegerlendirmeKalemi {
+    ad: string;
+    sayi?: number | null | undefined;
+    katki?: number | null | undefined;
+}
+interface Etkinlik {
+    ad: string;
+    sayi: number;
+    agirlik: number;
+    kaynak: string;
+}
+/** Değerlendirme kalemlerini iş yükü etkinliklerine çevirir. Eşleşmeyen kalem satır üretmez. */
+export declare function etkinliklereCevir(deg: readonly DegerlendirmeKalemi[]): Etkinlik[];
+export interface IsYukuSatiri {
+    ad: string;
+    sayi: number;
+    sure: number;
+    /** Değerin nereden geldiği: "sayfa (T+U+L)", "Değerlendirme kalemi: ..." ya da "Akredit önerisi". */
+    kaynak: string;
+    /** Hesabın varsayımı; hoca teyit eder. */
+    varsayim: string;
+}
+/**
+ * İş yükü dağılım önerileri (deterministik). Satırlar yalnız ders süresi, haftalık çalışma ve verilen değerlendirme
+ * kalemlerinden kurulur. Kurum değeri (bolen) verildiyse toplam tam AKTS × bolen olmaya çalışılır; verilmediyse
+ * AKTS × 30 hedeflenir ve AKTS başına 25-30 saat aralığı kabul edilir.
+ */
+export declare function isYukuDagilimlari(akts: number, tul: string, hafta?: number, bolen?: number, degerlendirme?: readonly DegerlendirmeKalemi[]): {
     secenek: number;
     ad: string;
     aciklama: string;
-    isyuku: {
-        ad: string;
-        sayi: number;
-        sure: number;
-    }[];
+    etiket: string;
+    isyuku: IsYukuSatiri[];
     toplam: number;
     hedef: number;
+    kabulAraligi: [number, number];
     tamEsit: boolean;
+    aralikta: boolean;
 }[];
+/**
+ * OBS'ye yazılan alanları geri okunan sayfa metniyle karşılaştırır. Ders kodu ya da dönem farklıysa durur:
+ * yanlış derse yazılmış olabilir.
+ */
+export declare function obsKarsilastir(g: {
+    dersKodu: string;
+    donem?: string | undefined;
+    beklenen: {
+        alan: string;
+        deger: string;
+    }[];
+    geriOkunan: {
+        metin: string;
+        dersKodu?: string | undefined;
+        donem?: string | undefined;
+    };
+}): {
+    dur: boolean;
+    nedenler: string[];
+    eslesen: number;
+    farkli: number;
+    alanlar: {
+        alan: string;
+        durum: "bos" | "farkli" | "eslesti";
+        eksikParcalar: string[];
+        eksikParcaSayisi: number;
+    }[];
+};
 export declare const BOLOGNA_ARACLARI: readonly AcikArac[];
 export {};