edumints SCORM MCP

Mevcut TÜM ekran tiplerini (build_from_spec/add_screen `screen.type` değerleri) ve kısa açıklamalarını listeler. Skorlanan tipler `scored:true` ile işaretlenir. Yeni bir kurs tasarlarken hangi ekran tiplerinin mevcut olduğunu görmek için çağır (keşif; proje gerektirmez).

Projedeki ekranları sıralı listeler.

Mevcut tema preset'lerini (build_from_spec/set_theme `theme` adı) ve konularına uygunluğunu listeler. Arayüzü konuya göre farklılaştırmak için uygun temayı seçmek üzere çağır (keşif).

Bir görsel + bir ses asset'ini sabit-görüntülü videoya (mp4, H.264/AAC) birleştirir (ffmpeg). E-öğrenme: slayt görseli + TTS seslendirme → seslendirilmiş video. Sonuç yeni asset olur; VideoScreen'de video_asset_id ile kullan. Faz 4 — LAZY: yalnız çağrılınca ffmpeg devreye girer.

Yerel medya klasörünün METADATA manifestini senaryonun BOŞ yuvalarıyla eşleştirir. `files`: [{name, size, sha256, mime}] — SUNUCU HİÇBİR DOSYA YOLUNA DOKUNMAZ (kabul #10; klasörü İSTEMCİ tarar: scripts/import_media_folder.py). Sinyaller: dosya adı ↔ slot_id/spec/source_hint token örtüşmesi, MIME ↔ kind, boyut makullüğü, sha256 zaten içeride mi ("dedup" — fill aynı id'yi döndürür). → {proposals: [{page_id, slot_id, role, kind, spec, proposed, candidates: [{name, score, reasons}]}], unmatched_files}. Belirsizlikte proposed=null + skorlu aday listesi — OTOMATİK ATAMA YAPILMAZ; onaylanan eşleşmele…

Bir ses asset'ini tarayıcı-güvenli mp3'e (44.1kHz/128k) normalize/transcode eder (ffmpeg). Çapraz-MCP'den gelen wav/ogg/m4a sesleri her tarayıcıda çalışsın diye. Faz 4 — LAZY.

Tek-dosya, harici bağımlılıksız önizleme üretir + hosted URL döndürür. v1.8.1: varsayılan yanıt HAFİF — `hosted_url`, `compositions`, `composition_questions`, `size_bytes` (sayfanın bayt boyutu). Tam HTML'i yanıtta istiyorsan `include_html=true` ver; kullanıcıya göstermek için `hosted_url` yeterlidir. BÜYÜK ÇIKTI UYARISI: `inline_html` tek dosyada her şeyi taşır (taban ~546 KB) ve gömülü artifact/asset'ler data-URI olarak base64'lenir (≈ boyut × 1.33; `html_to_asset` 25 MB'a kadar kabul eder). `wrap_artifact` ile sarılmış bir artifact'te `inline_html`'i bağlama çekmek yerine `hosted_url`'i k…

Projeyi KALICI herkese açık demo linkine yayınlar: {PUBLIC_BASE_URL}/demo/{slug}. `preview`'dan farkı: TTL YOK — link süresiz yaşar (README/vitrin/portföy linkleri için). Upsert: aynı slug'a tekrar yayınlamak içeriği günceller (yalnız slug'ı ilk yayınlayan sahip güncelleyebilir). slug: [a-z0-9-], 3-40 karakter. Demo HTML boyutu sahibin depolama kotasına dahildir (`enforce_size_quota`). Envanter için `list_demos`, kaldırmak için `unpublish_demo`.

Bir ekranı siler.

Sahne-spec'ten programatik motion-graphic / veri-viz MP4 üretir (HyperFrames) ve video asset olarak ekler. VideoScreen'de video_asset_id ile kullan. Faz 10 — LAZY/async. video_spec = VideoSpec JSON (scenes[].elements: text/shape/image/icon/chart + animation). Guardrail: ≤1920x1080, ≤60sn. Sahnede narration_asset_id varsa ses mux'lanır.

Mevcut bir stage ekranını (Faz 9 timeline'ıyla) MP4'e döker (HyperFrames). İndirilebilir özet / LMS video oynatıcısı için. Faz 10 — LAZY/async. duration_sec ≤ 60. quality (draft/standard/high) + fps ile hız/kalite dengesi (Faz 11).

Ekranları verilen id sırasına göre yeniden dizer. `screen_ids_in_order`, projedeki TÜM ekran id'lerini bire bir (eksiksiz, tekrarsız) içermelidir; aksi halde `validation_error` döner. add_screen sona ekler — sıralamayı değiştirmek/araya almak için bunu kullan.

Bir reviewer yorumunu 'çözüldü' işaretler (Claude düzeltmeyi uyguladıktan sonra).

Senaryoyu build_from_spec payload'una derler. ⛔ blocker varsa REDDEDER (blocker listesi ile). Derlenen spec: outline passthrough, sayfalar → ekranlar (screen_type derlemede ZORUNLU), body_md → sanitize HTML, kanıt/hedef bağları otoriter, faz adı ASLA basılmaz. Sonuç ayrıca üretilen spec'in tam lint_course raporunu içerir. compile_and_build=True → build_from_spec'e zincirler (proje oluşturulur + paketlenir).

Outline düğümünü siler. `strategy`: "refuse" (varsayılan — çocuk düğüm/sayfa varsa reddeder) | "reparent" (çocuk düğümleri düğümün ebeveynine, sayfaları ebeveyne taşır; kök düğümde sayfa varsa ebeveynsiz kalır → hata).

Sayfayı siler. Ona işaret eden evidence_from referanslarını TEMİZLER (sarkma bırakmaz); boşalan bağ scenario_gaps'te blocker olur (dangle değil).

Boşluk raporu = derleme KAPISI. {blockers (⛔), warnings (⚠), suggestions, evidence_binding_coverage_estimate}. Blocker varken scenario_compile REDDEDER. Denetimler sıra-bağımsız; screen_type YALNIZ önerilir (asla otomatik seçilmez).

Sayfaları verilen id sırasına dizer. Liste TÜM sayfa id'lerini bire bir içermelidir (eksik/fazla → validation_error). `order` alanları yeni sıraya göre yeniden atanır.

Senaryonun kompakt ağaç özetini döndürür (düğüm hiyerarşisi + sayfa satırları + node_id'siz sayfalar). Yazarlık gezinmesi için (tam doküman değil).

Outline düğümü ekler/günceller (id varsa günceller). Doküman yapısal denetimden geçer.

Sayfa ekler/günceller (id yoksa üretilir; varsa günceller). Sayfa şeması (kanıt ENUM oneOf, medya yuvası rolleri) doğrulanır. Boşluk/kanıt kapısı derlemededir (scenario_gaps).

Telifsiz (CC0/Public Domain) görsel arar — kurslara görsel eklemenin ilk adımı. `source`: "openverse" | "wikimedia". Yalnızca CC0/Public Domain lisanslı sonuçlar döner. Sonuçtan bir `url` seçip `add_asset(project_id, source=url, filename=...)` ile projeye ekle (indirme+SSRF denetimi orada yapılır — bu tool yalnız aday listeler, İNDİRME YAPMAZ). Her sonuç lisans/yazar/ kaynak-sayfa bilgisi taşır; uygun yerde yazarı kursa kredilendirin.

Projenin kompozisyon modunu ayarlar. "auto": odak/vurgu kademeleri/otomatik desen; "classic": eski görünüm (bayt-aynı). Mevcut bir projeyi yükseltmenin TEK yolu. visual (K2, ops.): görsel ekranlarda metin yeri tercihi — "stack" (üstte bant), "split" (solda sütun), "auto" (içeriğe göre). Verilmezse mevcut tercih korunur. question (K3, ops.): vakalı (uyaranlı) soru ekranlarında vakanın yeri — aynı değerler.

Tek bir ekranın kompozisyonunu ayarlar (desen adı, {"preset": …, ince ayar} nesnesi ya da None = otomatik seçime bırak). Ekranın diğer alanlarına DOKUNMAZ — update_screen'in aksine tüm ekranı yeniden göndermek gerekmez. `composition_questions` cevaplarını uygulamak için.

Tema token'larını uygular (kısmi override derin merge edilir).

Tamamlanma/geçme kriterini ayarlar.

Claude-üretimi SVG diyagramını SCORM asset'ine çevirir (base64 gerekmez — ham `svg_content` ver). Dönen `id`'yi `media_asset_id`/`image_asset_id`/blocks `asset_id` vb.'de kullan; ekran `<img>` ile yükler (responsive). ÖNEMLİ: SVG'yi `body_html`'e inline gömme — sanitizer `<svg>`'yi siler. `rasterize=true` → PNG (azami LMS uyumu; cairosvg gerekir). Aksi halde SVG (hafif, vektörel; modern LMS'lerde `<img>` ile zaten render olur). SUNUCUDA LLM YOK.

Metni Piper ile Türkçe seslendirmeye çevirir → mp3 narration asset (Faz 11). Ekranlarda narration_asset_id ile kullan. LAZY: Piper yoksa net hata. Üst kalite ya da başka dil için kendi TTS MCP'ni kullanıp add_asset ile yükle (çapraz-MCP akışı birincildir).

KALICI demo linkini kaldırır: metadata + HTML silinir; sonrasında `/demo/{slug}` 404 döner. Yalnız slug'ın sahibi kaldırabilir (store'dan doğrulanır; eski yalnız-.owner-dosyalı yayınlarda dosyadan).

Var olan bir ekranı günceller. `screen`: tipli ekran JSON nesnesi (`type` zorunlu) — ekran BÜTÜNÜYLE değiştirilir (gönderilmeyen içerik alanları silinir). İstisna (v1.8.1): `composition` anahtarı hiç gönderilmezse ekranın mevcut kompozisyon ezmesi KORUNUR (tip aynıysa); açıkça `null` → otomatik seçime döner. Geçersiz kompozisyon / alt'sız görsel vaka reddedilir.

Proje + (varsa) son paketin manifest/yapı doğrulamasını yapar.

Keyfi kendine-yeten HTML'i (Claude artifact) TEK ADIMDA izlenebilir SCORM içeriğine çevirir: proje + `embed_html` ekranı. Sonra `preview`/`build_package`/`publish_demo` çağır. Girdi: `html_content` ham string (küçük/orta) VEYA `source_url` https (büyük/uzak; SSRF-korumalı) — tam olarak biri (boş string DE "verilmiş" sayılır). `completion="time_threshold"` ise `min_seconds` > 0 ZORUNLU (kaç saniye sonra tamamlansın); diğer modlarda yok sayılır. `language` (varsayılan "tr", `create_project` ile AYNI): oynatıcı kabuğu + runtime i18n + LOM `general/language`. Proje yaratıldıktan SONRA hiçbir tool …