@docyrus/curiendo-studio

npm paket adı @docyrus/curiendo-studio, çalıştırılacak komut curiendo-studio olur.

Curiendo Creative Studio'nun komut satırı sürümü. Masaüstü uygulamasının bir etkileşimli öğrenme deneyimi yapmak için yaptığı her şey — projeler, Learning Blueprint, içerik belgeleri, derlemeler, kalite denetimleri, oynama testleri, paketler, okulun varlık kütüphanesi, okulun kredisini harcayan üretim ve incelemeye gönderilen taslak — bir kişinin ya da bir kodlama ajanının çalıştırabileceği komutlar olarak.

Bu bir istemcidir. Her izin, politika ve kurum denetimi sunucuda kalır; yalnızca uygulama erişim sınırının izin verdiği yere uzanır. Burada onaylayan, yayınlayan ya da bir okulun neye izinli olduğuna karar veren bir komut yoktur.

Phase 16 kapsamında planlanıp izleniyor. İngilizce: README.md.

Kurulum

npm install -g @docyrus/curiendo-studio
# ya da kurmadan:
npx @docyrus/curiendo-studio --help

Node 24 ya da daha yenisi gerekir. Başka bir şey ters gitmeden önce curiendo-studio doctor bu kurulumun neyi yapabildiğini ve neyi yapamadığını söyler.

Bu depo içinde, geliştirme sırasında komut node dev/cli.mjs olur: içe aktardığı çalışma alanı paketleri paketleyiciler için yazıldı, bu yüzden kaynaklarını Node altında çalıştırmak bir yükleyici kancası gerektirir ve dev/ onu barındırır. Yayınlanan paket derlenmiştir, ikisine de ihtiyacı yok.

Bütün döngü, sırayla

curiendo-studio doctor                       bu kurulum neyi yapabilir
curiendo-studio init                         bir ajan için Curiendo becerileri
curiendo-studio connect                      kendi tarayıcın, kendi okul hesabın
curiendo-studio project new "Kayaçlar" --format game --kit phaser-2d
cd kayaclar
curiendo-studio blueprint apply --from tasarim.json
curiendo-studio blueprint validate           tasarımda hâlâ ne eksik
curiendo-studio blueprint confirm            eğitimcinin kararı
curiendo-studio look choose sprite.pixel-crisp
curiendo-studio brief write                  yapım brief'i ve referans karesi;
                                             ikisinin de ücretini Curiendo öder
curiendo-studio brief handoff                yapımı yazan ajana verilen sözler
curiendo-studio build                        öğrencinin tarayıcısının yüklediği dosyalar
curiendo-studio check                        kalite denetimleri
curiendo-studio playtest run --script oyna.json
curiendo-studio package write                bir inceleyenin açtığı .tcgame
curiendo-studio push send                    okulda bir taslak sürüm
curiendo-studio push submit                  okuldan incelemesini iste

Okulun kendi içerik planından gelen iş bir komut önce başlar:

curiendo-studio roadmap next                 sıradaki işi üstlen ve
                                             brief'ini projeye yaz

Her grubun kendi sayfası var (İngilizce):

• Bağlanmak — oturum açma nasıl işler, neden tarayıcı
• Projeler — diskteki proje, kilidi, geçmişi
• Learning Blueprint — tasarım ve neyin kapısını tuttuğu
• Görünüm ve yapım brief'i — nasıl görünür, ajan neyden inşa eder
• Belgeler — her biçimin içeriği nerede yaşar
• Derlemek, denetlemek, oynamak
• Varlıklar ve üretim — kütüphane ve kredi harcamak
• Plan — ücretli iş, fiyatı ve yürütülmesi
• İşi göndermek — paketler, taslaklar, inceleme, Public Library
• Okulun içerik planı — yol haritası ve sıradaki işin üstlenilmesi
• Bir ajan için beceriler — init neyi yazar, neden
• Komutlar araç olarak (MCP) — mcp ve neyi esirgediği
• Karşılaşacağın sınırlar — boyutlar, bütçeler, tarayıcılar

Oturum açmak bilinçli olarak tarayıcıdır

--token, --password ya da API anahtarı yok. connect, Console'da bir yetkilendirme başlatır, onay verilecek adresi yazar ve yanıtın bu makinedeki bir loopback portuna dönmesini bekler.

Bu, programın bir eksiği değil, sınırın tasarımıdır: bir okul hesabı, bir kurumun içinde rolü olan bir kişinin hesabıdır ve o kişiye yalnızca kendi denetimindeki bir tarayıcıda sorulabilir. Şifre tutan gözetimsiz bir makine okulun tamamını tutar; bu kimlik bilgisini tutan gözetimsiz bir makine ise yalnızca verilen iznin listelediği sekiz yetkiyi tutar — Console'dan iptal edilebilir — ve başka hiçbir şeyi.

Bu programın yapmayacağı şeyler, ve sorarak yaptıkları

Para harcamaz. generate quote fiyatlar ve hiçbir şey ayırmaz; generate run harcayan tek çağrıdır ve klavyedeki kişiden --yes ister. plan agree de okulun kredilerini bağlar, aynı kuraldadır. İkisi de bir ajana araç olarak verilmez.

Yayınlamaz. push submit okuldan taslağı incelemesini ister. Onay, liste, fiyatı ve erişilebilirliği Console'da kararlaştırılır; bu türden hiçbir kimlik bilgisi oralara erişmez.

Eğitimcinin kararlarını sorar, ve onları yerine getirebilir. blueprint confirm (öğrenme tasarımı), push submit (taslağı incelemeye vermek) ve okulun içerik planı kararları; üçü de önce sorar, yani kimse klavyede yokken çalıştırmak --yes geçmek demektir: o çağrıda, kişinin yerine yanıt verdiğinizi söylemiş olursunuz. Bunlar bir ajana da açıktır, çünkü onun üzerinden çalışan bir eğitimci yolun yarısında bırakılmamalı. Programın zorlayamadığı ve asıl önemli olan kısmı, kurulan becerilerin yazdığı şey: tasarımı önerin, eğitimcinin önüne koyun, yalnızca istediklerinde onaylayın ve kimsenin okumadığı bir fikre asla karar vermeyin.

Çıktıyı okumak

Her komut öntanımlı olarak bir insan için yazar ve bir program için --json alır. --lang tr Türkçeye geçer; CURIENDO_LANG=tr de aynısını yapar.

Çıkış kodları yalnızca bir başarısızlık değil, yanıtın kendisidir: 0 yapıldı, 2 komut yanlıştı, 3 sunucu bu kimliği reddetti, 4 bulunamadı, 5 oradaki şeyle çakışma, 6 kimse yanıtlamadı, 7 hâlâ sürüyor, 8 işin kendisi reddedildi — başarısız bir denetim, geçersiz bir belge.

Ortamlar

--profile local | staging | production ya da CURIENDO_PROFILE. Öntanımlı olan production'dır. Her ortamın kendi kimlik dosyası ve kendi çalışma alanı vardır; aralarında hiçbir şey paylaşılmaz ve whoami her zaman hangisinden söz ettiğini söyler.

• Müfredat komutları: resmî katalog, çoklu müfredat etiketleri ve isteğe bağlı çalışma alanı bağlantıları.