@akredit/acik-mcp 0.1.0 → 0.5.0

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

@@ -0,0 +1,291 @@
+import { type Bulgu } from "../../../packages/cekirdek/src/index.js";
+import { z } from "zod";
+import { type AcikArac } from "./temel.ts";
+export declare const ALAN_KODLARI: readonly ["amac", "icerik", "yontem", "notlar", "onKosul", "ciktilar", "degerlendirme", "isyuku", "dersYapisi", "haftalar", "katki", "ska", "kaynaklar", "yetkililer"];
+export type AlanKodu = (typeof ALAN_KODLARI)[number];
+interface AlanBilgisi {
+    ad: string;
+    /** OBS düzenleme ekranındaki sekme (Proliz). */
+    sekme: string;
+    kurallar: string[];
+    sinir?: Record<string, number | string>;
+    kaliplar: string[];
+    yasaklar: string[];
+    /** MCP bu alanı taşıyabilir mi (kişisel veri sınırı). */
+    mcpTasir: boolean;
+}
+/** Akredit'in Bologna doldurma kuralları (packages/cekirdek/src/bologna/taslak.ts, apps/cli/skills/bologna-doldur). */
+export declare const ALANLAR: Record<AlanKodu, AlanBilgisi>;
+/** Bloom'un yenilenmiş sınıflaması düzeylerine göre örnek fiiller. Akredit örneğidir, resmî liste değildir. */
+export declare const BLOOM_FIILLERI: {
+    duzey: string;
+    fiiller: string[];
+}[];
+/** 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;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    icerik: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    yontem: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    notlar: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    onKosul: z.ZodOptional<z.ZodString>;
+    ciktilar: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kod: z.ZodString;
+        tr: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+        tur: z.ZodEnum<{
+            Bilgi: "Bilgi";
+            Beceri: "Beceri";
+            Yetkinlik: "Yetkinlik";
+        }>;
+    }, z.core.$strip>>>;
+    degerlendirme: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ad: z.ZodString;
+        sayi: z.ZodNumber;
+        katki: z.ZodNumber;
+    }, z.core.$strip>>>;
+    isyuku: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ad: z.ZodString;
+        sayi: z.ZodNumber;
+        sure: z.ZodNumber;
+    }, z.core.$strip>>>;
+    dersYapisi: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        alan: z.ZodString;
+        yuzde: z.ZodNumber;
+    }, z.core.$strip>>>;
+    haftalar: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        hafta: z.ZodNumber;
+        konu: z.ZodObject<{
+            tr: z.ZodString;
+            en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        onHazirlik: z.ZodString;
+        dokuman: z.ZodString;
+    }, 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>>;
+    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>;
+export interface Yetkili {
+    /** Sayfadaki etiket, ör. "Dersi Verenler". */
+    rol: string;
+    /** Sayfadaki değer, olduğu gibi. */
+    deger: string;
+}
+declare const DersTemeli: z.ZodObject<{
+    kod: z.ZodOptional<z.ZodString>;
+    ad: z.ZodOptional<z.ZodString>;
+    akts: z.ZodOptional<z.ZodNumber>;
+    tul: z.ZodOptional<z.ZodString>;
+    bolen: z.ZodOptional<z.ZodNumber>;
+    donem: z.ZodOptional<z.ZodString>;
+    yetkililer: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rol: z.ZodString;
+        deger: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type DersTemeliT = z.infer<typeof DersTemeli>;
+/** Taslak alanlarını cekirdek kurallarıyla denetler; yalnız verilen alanların bulgularını alan alan döndürür. */
+export declare function alanBulgulari(ders: DersTemeliT, alanlar: TaslakAlanlariT, s: {
+    ingilizce: boolean;
+    programCiktilari?: string[] | undefined;
+}): Map<AlanKodu | "genel", Bulgu[]>;
+/** Bütün sayılar burada hesaplanır; asistan toplam yazmaz (ilke 2). */
+export declare function bolognaHesabi(ders: DersTemeliT, alanlar: TaslakAlanlariT): {
+    isyuku: {
+        satirlar: {
+            ad: string;
+            sayi: number;
+            sure: number;
+            toplam: number;
+        }[];
+        toplam: number;
+        hedef: number | null;
+        hedefAraligi: [number, number] | null;
+        aralikta: boolean | null;
+        fark: number | null;
+        aktsBasinaSaat: number | null;
+        dersSuresiHaftalikBeklenen: number | null;
+        dersSuresiHaftalikVerilen: number | null;
+        aciklama: string;
+    } | null;
+    degerlendirmeToplami: number | null;
+    dersYapisiToplami: number | null;
+    ciktiSayisi: number | null;
+    haftaSayisi: number | null;
+};
+export declare const bolognaDenetleAraci: AcikArac<z.ZodObject<{
+    ders: z.ZodObject<{
+        kod: z.ZodString;
+        ad: z.ZodOptional<z.ZodString>;
+        zorunlu: z.ZodDefault<z.ZodBoolean>;
+        yariyil: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        tul: z.ZodOptional<z.ZodString>;
+        kredi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        akts: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        guncelleme: z.ZodOptional<z.ZodString>;
+        amac: z.ZodOptional<z.ZodString>;
+        icerik: z.ZodOptional<z.ZodString>;
+        yontem: z.ZodOptional<z.ZodString>;
+        notlar: z.ZodOptional<z.ZodString>;
+        kaynakSayisi: z.ZodOptional<z.ZodNumber>;
+        kaynaklar: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        yetkililer: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rol: z.ZodString;
+            deger: z.ZodString;
+        }, z.core.$strip>>>;
+        ciktilar: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kod: z.ZodString;
+            metin: z.ZodString;
+        }, z.core.$strip>>>;
+        degerlendirme: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ad: z.ZodString;
+            sayi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            katki: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        isyuku: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ad: z.ZodString;
+            sayi: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            sure: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            toplam: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        dersYapisi: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            alan: z.ZodString;
+            yuzde: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        haftalar: z.ZodDefault<z.ZodNumber>;
+        katki: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>;
+    programCiktilari: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kod: z.ZodString;
+        metin: z.ZodString;
+    }, 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;
+/**
+ * Yapıştırılan HTML'den görev satırlarını (Dersi Verenler, Yardımcılar, Koordinatör) yetkililer listesine, kaynak
+ * satırlarını künye listesine ayırır. Değerler olduğu gibi korunur; hiçbir şey atılmaz.
+ */
+export declare function bolognaSatirAyikla(html: string): {
+    html: string;
+    yetkililer: Yetkili[];
+    kaynaklar: string[];
+};
+/** bologna_ayristir ön ayıklaması: yalnız giriş bilgisi (oturum kimliği, parola kutusu, çerez) atılır. */
+export declare function ayristirOnAyikla(g: unknown): {
+    girdi: unknown;
+    atilan: string[];
+    ileti?: string;
+};
+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;
+    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 {};