@akredit/acik-mcp 0.4.0 → 0.5.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";
@@ -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 {};