Uyumluluk: Node.js 22.14+ veya 24.x üzerinde Pactmark 0.2.x. Üretilen proje deterministik bir yerel model kullanır; bu hızlı başlangıç için sağlayıcı hesabı gerekmez ve kurulumdan sonra hiçbir ağ çağrısı yapılmaz.

1. Projeyi oluşturun

Başlatıcı deterministik ve çevrimdışıdır: her dosyayı planlar, planı yazdırır ve ancak ondan sonra diske yazar. Projenizin nasıl görüneceğine karar vermek için ağdan hiçbir şey çekilmez.

Şablon seçimi

Etkileşimsiz
--dry-run --json ekleyin: dosya sistemine dokunmadan planın tamamını — her dosya yolunu içerik özetiyle, tam bağımlılık sürümlerini ve çalıştırılacak komutları — yazdırır. Kontrollü bir ortamda başlatıcıyı gözden geçirmenin önerilen yolu budur.

2. Çalıştırın

Bir koşunun üç olaydan geçip sonlandığını görmelisiniz:
Beklenen çıktı
productionReady: false doğrudur ve kasıtlıdır. Geliştirme profili geçici bir bellek deposu kullanır; bu yüzden hazırlık kontrolü kalıcı bir üretim profilini karşılayamayacağını dürüstçe bildirir. Burada true bildiren bir çerçeve size yalan söylüyor olurdu.

3. Ne ürettiğine bakın

Bu koşu geriye bir metinden fazlasını bıraktı. Her komut doğrulanmış olaylar ekledi ve incelediğiniz projeksiyon bunların üzerine katlanmış bir sonuçtur. Şekil 1. Sürekli güveneceğiniz ilişki: olaylar gerçektir, projeksiyon bir önbellektir. Bir Pactmark koşusunun bambaşka bir süreçte devam ettirilebilmesinin nedeni budur. Koşuyu CLI’dan inceleyin:
replay komutunu erken anlamakta fayda var: sonlanmış bir koşuyu, hiçbir araç veya model çalıştırmadan, saklanan olaylar ve artifact’lardan doğrular. Bir koşu yeniden oynatılamıyorsa geçmişi sağlam değildir.

4. Ortamınızda neyin eksik olduğunu görün

doctor, gereken dayanıklılık, sandbox, kimlik bilgisi, politika veya kayıt kanıtı yoksa başarısız olur. Taze, bellek destekli bir projede başarısız olmalıdır — bildirdiği boşlukları bir hata değil, üretim yapılacaklar listeniz olarak okuyun.

Sonraki adımlar

Sıfırdan bir ajan yazın

Aynı koşu, elle yazılmış ve her nesnesi açıklanmış hâli.

Modeli anlayın

API’nin keyfi hissettirmesini bitiren altı fikir.

Gerçek bir araç tanımlayın

Risk sınıfı, kapsamlar, egress, etki stratejisi ve kayıt özetleri.

Kalıcı depolamaya geçin

Göçler, fenced kiralar, korumalı bağlam ve ayrı işletilen bir worker.

Kurtarma

Kurulum not found döndürüyorsa yapılandırılmış registry’yi, ağ erişiminizi ve istenen sürümü doğrulayın. Doğrulanmamış benzer isimli bir pakete geçmeyin — yayımlanmış tek isimler @pactmark kapsamı ve create-pactmark’tır. Bir koşu başarısız olursa kararlı KAF_* koduna göre dallanın ve koşu olay akışını inceleyin. İngilizce hata metnini asla API olarak ayrıştırmayın; o mesajlar tanılamadır ve değişebilir.