atl update

Kurulu takımları yenile: güncel bir katalog indeksi çek, yeni sürüm yayınlanmış her takımı yükselt, global katmandaki kazanımları proje kopyalarına yay ve platform çekirdeğinin son sürümünü global katmana yansıt — yerel olarak düzenlediğin dosyalara her zaman dokunmadan (çek, asla itme).

atl update, ağ yenilemesinin elle çalıştırılan yüzeyidir. Günlük iş oturum içi kadans aracılığıyla otomatik olarak yürütülür; bu komutu yalnızca bir geçişi zorlamak istediğinde ya da ikili dosyayı elle kurduğunda çalıştırmak gerekir.

Kullanım

atl update

Hiçbir argüman ve bayrak almaz. Her zaman mevcut proje (çalıştırdığın dizin) ile global katman üzerinde çalışır.

Ne yapar

atl update sırayla dört adım çalıştırır:

1. İndeks önbelleğini yeniler. Katalogdan (GitHub destekli takım indeksi) ~/.atl/index.json konumuna en iyi çaba ağ çekimi yapar. Çevrimdışıysan çekim sessizce başarısız olur ve çözümleme önbelleğe alınmış ya da gömülü indekse geri döner — çevrimdışı olmak normaldir; başka hiçbir şey engellenmez.
2. Takımları daha yeni yayınlanan sürümlere yükseltir. Proje ve global katmanlarda kurulu her takım için atl update, takımı çözümlenen indekste arar. Yayınlanan sürüm kurulu olandan yeniyse takımın kaynağını tek kullanımlık bir HTTPS tar dosyası olarak yeniden çeker, açar ve kurulu kopyaya yayma disiplini kapsamında yansıtır: değiştirilmemiş dosyalar yeni sürüme yenilenir, düzenlediğin dosyalar korunur, sürümde bulunan yeni dosyalar eklenir. Ardından kurulum bildirimi yeni sürümle yeniden yazılır. İndekste bulunmayan takımlar (örneğin yerel bir takım) olduğu gibi bırakılır.
3. Global kazanımları projeye yayar. Hem global hem proje katmanında kurulu her takım için proje-yerel dosyaların her biri üç yönlü karşılaştırmayla denetlenir (aşağıya bkz.). Değiştirilmemiş proje kopyaları global kopyadan yenilenir; yerel olarak düzenlediğin dosyalar korunur. Bir kazanımın global katmana yükseltildikten sonra projelerine ulaşması böyle sağlanır.
4. Platform çekirdeğini global katmana yansıtır. Çekirdek kurallar ve beceriler atl ikili dosyasının içinde paketlenir; bu adım onları ~/.claude konumuna yenileyerek global katmanı ikili sürüm numaranla eşzamanlı tutar.

Yükseltme veya yayma işleminin ardından, global katmana kurulu olup global kopyasında henüz yukarı akışa gönderilmemiş kazanımı bulunan her takım için bir satırlık bir öneri de gösterir (bkz. Yayınlama önerileri).

Çıktı

Özet satırı ne olduğunu yansıtır:

atl update: upgraded 1 team(s), refreshed 14 file(s) from global

atl update: upgraded 1 team(s)

atl update: refreshed 14 file(s) from the global layer

Bekleyen bir şey yoksa:

atl update: everything up to date

Çekirdek dosyalar değiştiyse özetten önce ayrı bir satır görünür:

atl update: refreshed 3 core file(s)

Yayma disiplini — düzenlemelerinin nasıl korunur

Hem sürüm yükseltmesi (2. adım) hem de global→proje yayması (3. adım), her dosyayı kurulum anındaki hash ile karşılaştıran (kurulum bildirimi içinde kayıtlı) aynı üç yönlü SHA-256 karşılaştırmasıyla değerlendirir:

Karşılaştırma	Anlam	İşlem
yerel = yukarı akış	zaten güncel	yapılacak bir şey yok
yerel = kurulum referans hattı	hiç dokunmadın	yukarı akış/global sürüme yenile
yerel ≠ referans hattı	düzenledin	koru — kopyat saklanır

"Değiştirilmiş" demek "kurduğumuzdan bu yana ayrışmış" demektir, salt "yukarı akıştan farklı" değil. Hiç değiştirmediğin dosya yenilenir; değiştirdiğin dosya hiçbir zaman sessizce üzerine yazılmaz. Bir kopya yenilendiğinde referans hattı yeni içeriğe ilerler; böylece bir sonraki geçiş temiz başlar.

Zorla üzerine yazma bayrağı yoktur. Yerel düzenlemeleri kasıtlı olarak atmak ve yayınlanan sürümü almak istersen takımı kaldırıp yeniden kurabilirsin:

atl remove <handle>/<team>
atl install <handle>/<team>

Kurulum bildirimi

Yaymanın karşılaştırdığı referans hattı takımın kurulum bildiriminde yaşar — kapsam başına bir JSON dosyasında:

• ~/.atl/installed/<handle>__<name>.json (global)
• <project>/.atl/installed/<handle>__<name>.json (proje)

Her bildirim schemaVersion, handle, name, version, scope, çekildiği source (repo, subpath, ref), installedAt ve kurulum anındaki SHA-256 değerleriyle her kurulu yolun eşlendiği files haritasını kaydeder. atl update bu haritayı "değiştirilmemiş" ile "düzenlenmiş" arasında ayrım yapmak için okur ve bir takımı değiştirdiğinde onu (sürümü, kaynak ref'ini ve referans hash'lerini ilerleterek) yeniden yazar.

Otomatik güncellemeler — oturum içi kadans

atl update'i elle nadiren çalıştırsın çünkü ATL her şeyi otomatik güncel tutar. atl setup-hooks (atl install'ın zorunlu bir parçası olarak çalıştırılır) iki Claude Code hook'u bağlar:

• SessionStart → atl session-start — önceki oturumun öğrenmelerini boşaltır, doktor öz denetimini çalıştırır ve platform çekirdeğini global katmana yansıtır.
• UserPromptSubmit → atl tick --throttle=10m — ucuz bir istem başına yayma (global→proje) işlemi; kısıtlamalı bir boşaltma + doktor + yükseltme geçişi içerir.

İstem başına atl tick, yerel yaymayı sürekli halleder; bu sayede global katmanına yükseltilen kazanımlar sen hiçbir şey yapmadan projelerine ulaşır. atl update ağ kısmını ekler — indeksi yeniden çözerek ve daha yeni yayınlanmış takım sürümlerini çekerek — bu daha ağır geçişi elle (ya da yeni sürümleri şimdi kontrol etmek istediğinde) çalıştırsın.

Yayınlama önerileri

Bittikten sonra atl update, global olarak kurulu her takımda global kopyanda henüz yayınlanan sürüme geçmemiş kazanımları denetler ve takım başına bir uyarı yazdırır:

atl update: gains in <handle>/<team> not yet upstream (3 file(s)) — run `atl publish <handle>/<team>` to contribute them

Bu yalnızca bir öneridir — hiçbir şey otomatik olarak yayınlanmaz. Yayınlamak açık, onay gerektiren bir eylem olarak kalır; bkz. atl publish. Denetim en iyi çaba bazındadır ve takımın yayınlanan kaynağı çekilemezse sessiz kalır.

Çevrimdışı davranış

atl update çevrimdışında sorunsuz degrade eder. İndeks yenilemesi ve tüm tar dosyası çekimleri sessizce başarısız olur, çözümleme önbelleğe alınmış/gömülü indekse geri döner ve yeniden çekimi yapılamayan takımlar yükseltilmez. Yerel global→proje yayması (3. adım) ağ bağlantısı gerektirmez ve yine de çalışır.

İlgili

• atl install — takımın ilk kurulumu
• atl tick — projeleri otomatik güncel tutan istem başına yayma + boşaltma geçişi
• atl setup-hooks — otomasyon hook'larını bağla
• atl promote — projenin kazanımlarını global katmana yükselt (yaymanın dağıttığı içeriğin kaynağı)
• atl publish — global kazanımları yukarı akışa gönder
• atl list — neyin kurulu olduğunu ve hangi kapsamda olduğunu gör