Total.js Forge yalnızca çalıştırılabilen reçeteleri yayınlıyor, yapay zeka asistanları için MCP endpoint'leriyle

Total.js ekibi, her kod örneğinin yayınlanmadan önce çalıştırıldığı, Total.js 5 framework'ü ve jComponent 20 istemci kütüphanesi için bir reçete sitesi olan Forge'u başlattı. Ekibin dev.to üzerindeki duyurusuna göre, doğrulama çalışmasını geçemeyen bir reçete asla siteye ulaşmıyor. İfade edilen hedef, çoğu geliştiricinin tanıdığı bir sorunu ortadan kaldırmak: yazıldığı sırada doğru olan ama framework geliştikçe sessizce bayatlayan dokümantasyon örnekleri.

Arkasındaki framework

Total.js 5, bağımlılıksız bir çekirdeğe sahip bir Node.js framework'üdür. Routing, WebSocket, kimlik doğrulama, oturumlar, dosya yükleme, zamanlanmış görevler, e-posta, view'lar, proxy, yerelleştirme ve gömülü bir NoSQL veritabanı hepsi kutudan çıkar; böylece tipik bir proje, uzun bir bağımlılık kurulumu veya önceden verilmesi gereken bir yığın karara girmeden başlar.

Yayınlanmadan önce doğrulama

Her reçete, örnek kodu, o kodun ait olduğu dosya yollarını ve gizli bir test bloğunu içeren bir Markdown sayfasıdır. Tek bir komut olan npm run validate her reçeteyi sınar. Total.js 5 reçeteleri için süreç geçici bir uygulama oluşturur, dosyaları yazar, uygulamayı başlatır ve canlı örnek üzerinde kontroller çalıştırır — HTTP çağrıları, WebSocket bağlantıları, gerçek SQLite transaction'ları, OpenLDAP ve dosya yükleme bunların arasındadır. jComponent reçeteleri Chromium'da headless olarak çalıştırılır. Her çalıştırma makine tarafından okunabilir bir makbuz bırakır ve başarısız olan her reçetenin yayınlanması engellenir.

Sitede neler var

Yayınlanan içerik arasında route'lar, action'lar, WebSocket, kimlik doğrulama, yükleme, SQL ve NoSQL, Flow, bundle'lar, release modu ve LDAP konularını kapsayan 100'den fazla Total.js 5 reçetesi ve tarayıcı içinde canlı editör ile önizleme sunan 30 jComponent reçetesi bulunuyor. Reçetelerin çevresinde, her biri yazarına ve kaynağına atfedilmiş şekilde Componentator bileşen kataloğunu belgeleyen 330'dan fazla sayfa yer alıyor. Referans materyali, Express'ten Total.js'a geçiş rehberi ve yanlış kodu doğru sürümle eşleştiren bir sayfanın yanı sıra tüm globalleri, her CONF anahtarını, NEWACTION bildiriminin seçeneklerini, route sözdizimini ve giriş tiplerini listeliyor. Site 15 dilde mevcut — İngilizce ve 14 çeviri — ancak yalnızca metin kısımları çevrilidir; gösterilen kod, tam olarak çalıştırılan kodun kendisidir.

Forge ayrıca Total.js 5'i Total.js 4, Node.js, Express, Fastify, Koa, Hapi, Hono, Polka, Restify, NestJS, AdonisJS ve Meteor ile karşılaştıran tekrarlanabilir benchmark'lara ev sahipliği yapıyor. Benchmark uygulamaları, lock dosyaları, runner ve ham sonuçlar depoda bulunuyor ve bir doğrulama adımı, yayınlanan sayfaların temel verilerle hâlâ eşleştiğini kontrol ediyor.

Modeller tarafından okunmak üzere tasarlandı

İkinci bir tasarım hedefi, yapay zeka asistanlarının Forge'u scraping yapmadan tüketebilmesi. Site bir llms.txt dizini ve tam içerikli bir varyant, her sayfa Markdown olarak ve üç JSONL veri kümesi sunuyor: soru-cevap çiftleri, testli görevler ve yanlış-doğru kod çiftleri. Salt okunur bir MCP sunucusu; arama, sayfa, test ve ürün araçlarının yanı sıra Forge_verify_api adında bir araç sunuyor: ona bir kod parçası gönderiyorsunuz ve o, her global adını ve üyesini referans sayfalarına karşı kontrol ediyor; böylece bir asistan, cevap vermeden önce bir sembolün gerçekten framework'ün parçası olduğunu doğrulayabiliyor. Araç kodu okuyor ama asla çalıştırmıyor ve göremediği şeyleri işaretliyor. İyi bilinen dosyalar MCP sunucu kartını, agent becerilerini ve bir API kataloğunu yayınlıyor. Tüm içerik CC-BY-4.0 lisanslı olduğundan eğitim, değerlendirme veya diğer araçlarda bağlam olarak yeniden kullanılabilir.

Benchmark'ların ortaya çıkardığı bir bulgu

Ekip, saniyede on binlerce istek üzerinden throughput ölçerken, total5 0.0.19 sürümünde tamamlanmış isteklerin listesinin temizlenmesinin çok yüksek oranlarda maliyetli hale geldiğini söylüyor. Bunu, yaklaşık bir dakikada çalışan bir yeniden üretim, küçük bir yama ve öncesi-sonrası sayılarıyla belgelediler — yamayla birlikte, kendi makinelerinde tek bir sürecin hedefi saniyede 80.000 isteğe kadar tuttuğunu bildiriyorlar. Yazı, ekibin Forge yönteminin minyatürü olarak çerçevelediği şekilde framework'ün yazarlarının incelemesi için bir öneri olarak benchmarks/FINDINGS.md içinde yer alıyor: ölç, gördüğünü kaydet, tekrarlanabilir yap.

Neden önemli

Dokümantasyon kayması geliştirici zamanı üzerinde kronik bir vergidir ve yapay zeka destekli kodlamanın yaygınlaşması bunu daha da kötüleştirdi: bayat örneklerle eğitilen veya yönlendirilen modeller eski API'leri güvenle yeniden üretiyor. Forge soruna iki uçtan saldırıyor. İnsan tarafında, makine tarafından okunabilir makbuzlarla çalıştırılabilir reçeteler, tarif kitabının belgelediği framework'ten sessizce sapamamasını sağlıyor. Makine tarafında, llms.txt, JSONL veri kümeleri, salt okunur bir MCP sunucusu ve sembol doğrulama endpoint'i asistanlara cevaplarını tahmin etmek yerine framework'ün gerçek yüzeyine karşı kontrol etme imkanı veriyor ve CC-BY-4.0 lisansı herkesin bu materyali eğitim veya değerlendirme hatlarına katmasını sağlıyor. Bir uyarı geçerli: buradaki ayrıntılar ve rakamlar tek bir satıcı duyurusundan geliyor ve throughput sayıları ekibin kendi donanımında üretildi; bu nedenle bağımsız doğrulama hâlâ yapılmamış durumda.