Mod Edit ve Write tool'larını hook'lar. Bir kaynak dosyada (.ts, .tsx, .js, .jsx, .mjs, .cjs, .vue, .svelte, .astro, .php, .py, .rb, .erb, .haml, .slim) başarılı bir çağrıdan sonra edit'in eklediği translation çağrılarını okur: new_string içinde olup old_string içinde olmayanları, ya da bir Write'ın her çağrısını.

Okunan çağrılar, tırnaklı ilk argümanı olan t, $t, i18n.t, __, trans, trans_choice, @lang, _, gettext ve ngettext; ayrıca this., vm., i18n., $i18n., I18n. ve i18n.global. sonrası biçimleri. Değişken argüman, template literal ve Rails lazy key (t('.title')) atlanır.

Locale dosyalarını session dizininin şu dizinleri altında, en fazla 4 seviye derinlikte ve 200 dosya olarak okur: locales, lang, i18n, translations, locale, config/locales, resources/lang, src/locales, src/i18n, public/locales. Session dizini, session'ın başladığı dizindir ve başlangıçta bir kere okunur, çünkü bir Bash cd session'ın kendi dizinini taşır. Edit edilen dosya da o dizine göre adlandırılır, yani proje içindeki bir path proje kökünden yazılır.

Dil bir dizinden (tr/, en-US/) ya da dosya adından (tr.json, messages.tr.yaml) gelir. Bir namespace dosyasındaki key aynı zamanda ns.key ve ns:key olarak da sayılır.

Bir key, bir dilde yoksa ya da hiçbir dilde yoksa eksiktir. Her key çağrıldığı satırla adlandırılır, böylece açabilirsiniz. Model bu notu Edit'in sonucundan sonra okur:

i18n-watch: this edit uses translation keys the locale files lack: checkout.total:42 (missing in tr, de) · checkout.vat:58 (missing in every locale). Add them to each locale file.

En fazla 10 key adlandırılır, kalanı sayılır.

Aynı anda transcript'e bir satır yazılır, böylece modele ne söylendiğini görürsünüz. Bu satır yalnız key'leri taşır, talimat cümlesi olmadan:

i18n-watch: keys the locale files lack: checkout.total:42 (missing in tr, de) · checkout.vat:58 (missing in every locale)

Not ve satır ayrı iki kanaldır: model satırı hiç okumaz, siz notu hiç okumazsınız.

sidebar açıkken bu key'ler oraya gider, key başına bir satır olarak, stream'inde bir entry halinde, ve transcript temiz kalır. Entry, yenileri pane'den itene kadar durur. Sidebar kapalıyken ya da o mod kurulu değilken transcript satırı yukarıdaki gibi yazılır.

Bir bulgu hiçbir zaman hatırlanmış bir cevap değildir. Tuttuğu key'ler bir iddiadır ve her ölçüm kaynak dosyayı diskten yeniden okur ve artık çağırmadığı key'leri düşürür. Yani bir bulgu iki yoldan kapanır ve ikisi de her Edit ve Write'tan sonra, ve bir guarded git komutundan önce ölçülür:

• her locale key'leri kazandı;
• kod onları çağırmayı bıraktı, çünkü edit string'i sildi, başkasıyla değiştirdi ya da başka bir dosyaya taşıdı. Silinmiş bir dosya da bulgusunu kapatır.

Entry temizlenir ve yeni bir satır hangisi olduğunu söyler:

i18n-watch: every locale now has the keys src/Cart.vue lacked: checkout.total · checkout.vat
i18n-watch: index.php no longer uses: Unauthorized Access

Sidebar kapalıyken aynı metin tek bir transcript satırıdır. Model bunun hiçbirini okumaz: bulgu kendi işiyle kapandı, bir not yalnız az önce yaptığını tekrar ederdi. Var olan ama okunamayan bir dosya bulgusunu açık tutar, çünkü okunamayan bir dosya hiçbir şeyi kanıtlamaz.

Modelin kapatmadığı bir bulgu her ana döngü turunun sonunda yeniden ölçülür ve kalan, bir sonraki prompt'la modele tek bir not olarak ulaşır:

i18n-watch: 1 file(s) still use translation keys the locale files lack: index.php (Unauthorized Access:42). Add the keys to every locale file, or take the calls out.

Tur başına bir not, prompt başına değil. Bu olmasa bulgu bir kere, edit anında söylenir ve sonra model onu unutmuşken pane'de dururdu. Siz yeni bir şey okumazsınız: pane zaten aynı bulguyu taşıyor.

deny modunda mod ayrıca, bir dosya locale dosyalarının tutmadığı key'leri kullandığı sürece git commit, git push ve git merge komutlarını durdurur. Bir git commit yalnız kendi dosyaları için cevap verir: mod index'i okur (git diff --cached --name-only) ve index açık dosyaların hiçbirini tutmuyorsa commit'in çalışmasına izin verir, size kaçının hâlâ durduğunu söyleyen bir satırla. Bir push ve bir merge okunacak index tutmaz, yani orada her bulgu durur. Kaçış yolu yok; gate'i yalnız kişi /i18n-watch mode note ile kapatır. note modu varsayılandır ve hiçbir şeyi durdurmaz, ama bulguları bir git komutunda yine de ölçer, böylece çözülmüş bir bulgu pane'de kalmaz.

The mod hooks the Edit and Write tools. After a successful call on a source file (.ts, .tsx, .js, .jsx, .mjs, .cjs, .vue, .svelte, .astro, .php, .py, .rb, .erb, .haml, .slim), it reads the translation calls the edit added: those in new_string that old_string does not have, or every call of a Write.

The calls read are t, $t, i18n.t, __, trans, trans_choice, @lang, _, gettext and ngettext with a quoted first argument, also after this., vm., i18n., $i18n., I18n. and i18n.global.. A variable argument, a template literal and a Rails lazy key (t('.title')) are skipped.

It reads the locale files under these directories of the session directory, at most 4 levels deep and 200 files: locales, lang, i18n, translations, locale, config/locales, resources/lang, src/locales, src/i18n, public/locales. The session directory is the one the session started in, read once at its start, because a Bash cd moves the session's own directory. The edited file is named against that directory too, so a path inside the project is written from the project root.

The language comes from a directory (tr/, en-US/) or from the file name (tr.json, messages.tr.yaml). A key in a namespace file also counts as ns.key and ns:key.

A key is missing when a language lacks it, or when no language has it. Each key is named with the line it is called on, so you can open it. The model reads this note after the Edit's result:

i18n-watch: this edit uses translation keys the locale files lack: checkout.total:42 (missing in tr, de) · checkout.vat:58 (missing in every locale). Add them to each locale file.

At most 10 keys are named, the rest counted.

The same moment writes one line to the transcript, so you see what the model was told. The line holds the keys alone, without the instruction:

i18n-watch: keys the locale files lack: checkout.total:42 (missing in tr, de) · checkout.vat:58 (missing in every locale)

The note and the line are separate channels: the model never reads the line, and you never read the note.

While the sidebar is open, those keys go there instead, one line per key, as an entry in its stream, and the transcript stays clean. The entry stays until newer ones push it off the pane. With the sidebar closed, or without that mod installed, the transcript line is written as above.

A finding is never a remembered answer. The keys it holds are a claim, and every measure reads the source file from disk again and drops the keys it no longer calls. So a finding closes two ways, and both are measured after each Edit and Write and again before a guarded git command:

• every locale gained the keys;
• the code stopped calling them, because the edit deleted the string, replaced it with another one or moved it to another file. A file that is gone closes its finding too.

The entry is cleared and a new one says which of the two it was:

i18n-watch: every locale now has the keys src/Cart.vue lacked: checkout.total · checkout.vat
i18n-watch: index.php no longer uses: Unauthorized Access

With the sidebar closed the same text is one transcript line. The model reads nothing of this: the finding closed by its own work, so a note would only repeat what it just did. A file that is there and cannot be read keeps its finding, because an unread file proves nothing.

A finding the model did not close is measured again at the end of each main-loop turn, and what is left reaches the model as one note with its next prompt:

i18n-watch: 1 file(s) still use translation keys the locale files lack: index.php (Unauthorized Access:42). Add the keys to every locale file, or take the calls out.

One note per turn, not one per prompt. Without this the finding would be said once, at the edit, and then stand in the pane while the model forgot it. You read nothing new: the pane already carries the same finding.

In deny mode the mod also stops git commit, git push and git merge while a file still uses keys the locale files lack. A git commit answers for its own files alone: the mod reads the index (git diff --cached --name-only) and lets the commit run when it holds none of the open files, with one line to you naming how many still stand. A push and a merge hold no index to read, so every finding stands there. There is no bypass; only the person turns the gate off with /i18n-watch mode note. note mode is the default and stops nothing, but it measures the findings at a git command all the same, so a settled one does not stay in the pane.