Exit Code 2: Mencegah Tabrakan File Terminal AI Paralel

Lo buka tiga terminal. Terminal satu ngerjain auth, terminal dua ngerjain dashboard, terminal tiga refactor API client. Protokol Exit Code 2 dirancang khusus untuk memastikan ketiga sesi ini tidak saling menabrak dan merusak kode. Dua jam kemudian semua selesai, lo git add -A, dan git history tetap bersih dan rapi.

Penyebabnya sederhana tapi nyebelin: ketiga sesi itu menyentuh file yang sama. Terminal satu menambah import di server.go, terminal dua menghapus blok yang sama persis, terminal tiga menulis ulang file itu dari snapshot lama. Yang terakhir menang, dua pekerjaan lain hilang tanpa peringatan.

Merge conflict masih bisa lo selesaikan dengan tangan. Yang nggak bisa lo selamatkan itu keputusan yang sudah ditimpa dan nggak pernah tersimpan di git.

Ibaratnya tiga tukang cat mengecat satu dinding tanpa koordinasi. Masing-masing bawa warna sendiri, dan hasil akhirnya bukan campuran, tapi lapisan terakhir yang nutupin semuanya.

Mekanisme Exit Code 2: Menembak Sebelum Tabrakan Terjadi

Reaksi pertama biasanya: pasang lock file. Ambil .git/index.lock sebagai contoh, atau tulis file .lock manual sebelum edit.

Masalahnya muncul di kondisi nyata.

Lock berbasis file itu binary: terkunci atau bebas. Kalau proses yang memegang lock crash, lock-nya tetap ada dan seluruh tim diblokir sampai ada yang menghapus manual. Kalau sesi lo lupa melepas, besok pagi repo nggak bisa dipakai.

Lock file juga tidak punya pemilik. Ia tahu ada yang mengunci, tapi tidak tahu siapa, tidak tahu sedang mengerjakan apa, dan tidak bisa mengirim pesan ke pemegangnya.

Dan yang paling fatal, lock granularitasnya sering salah. Satu lock per repo terlalu kasar, bikin seluruh sesi antre padahal file-nya beda. Satu lock per file terlalu halus, karena dua file di package yang sama bisa saling merusak kontrak.

Yang dibutuhkan bukan lock. Yang dibutuhkan koordinasi.

Forensik: Race Condition yang Tidak Terlihat

Filesystem lokal tidak punya konsep transaksi antar-proses. Dua proses yang menulis file yang sama akan saling menimpa, dan yang selesai terakhir menentukan hasil akhir. Ini race condition klasik, dan editor modern tidak melindungi lo dari situ karena masing-masing proses merasa berhak menulis.

Yang membuatnya berbahaya di alur agen AI: agen tidak membaca file tepat sebelum menulis. Ia membaca di awal turn, lalu berpikir ratusan milidetik, lalu menulis. Di jeda itu, sesi lain bisa mengubah file yang sama.

Jadi cek "apakah file berubah" sebelum menulis pun tidak cukup. Yang dibutuhkan adalah klaim yang dipegang selama durasi kerja, bukan selama durasi satu syscall.

The Unfair Advantage: Decoupled Swarm Mesh

ACS Core memasang dua mekanisme yang bekerja berlapis.

Lapis pertama, Session Bus. Ini bus IPC lokal berbasis SQLite WAL yang menyimpan daftar sesi aktif, klaim resource, dan pesan antar-sesi. Setiap sesi mendaftarkan diri dengan identitas unik, lalu bisa mengklaim resource berupa package directory, bukan file tunggal.

Klaim punya TTL. Kalau sesi mati mendadak, klaim kedaluwarsa sendiri dan tidak meninggalkan lock yatim. Sesi lain juga bisa membaca inbox dan mengirim pesan langsung ke pemegang klaim.

Lapis kedua, Package Boundary Armor. Ini hook PreToolUse yang berjalan sebelum setiap operasi Write atau Edit. Ia memeriksa apakah package dari file target sedang diklaim sesi lain. Kalau iya, operasi ditolak dengan Exit Code 2 dan pesan yang menyebut nama package, ID sesi pemegang klaim, dan instruksi untuk berkoordinasi lewat Session Bus.

Yang membuat desain ini beradab: fail-open. Kalau Session Bus tidak tersedia, hook tidak memblokir apa pun. Developer tunggal tidak pernah kena friksi lock. Dan sesi yang mengklaim resource-nya sendiri selalu lolos tanpa pengecekan tambahan.

[SWARM-MESH] Sesi B mendeteksi file sedang dikerjakan Sesi A
             Intercepted with Exit Code 2 (Package Boundary Armor)

Alih-alih file tertimpa diam-diam, lo dapat pemberitahuan sebelum kerusakan terjadi.

Protokol Air-Lock Exit Code 2 dan Koordinasi Bus

Kapan Ini Benar-Benar Menyelamatkan Lo

Kalau lo kerja solo dengan satu terminal, armor ini praktis tidak terasa. Itu memang tujuannya.

Nilainya muncul saat lo menjalankan beberapa sesi paralel, atau saat tim lo punya beberapa agent CLI yang menembak repo yang sama. Di situ, satu intervensi Exit Code 2 jauh lebih murah daripada satu jam memulihkan git history yang rusak.

Cara kerja lengkapnya, termasuk pembagian 21 persona ke dalam mesh terkoordinasi, ada di seksi swarm ACS. Pilihan lisensi untuk mengaktifkan armor ini ada di halaman harga. Pelajari standar kode status proses POSIX di GNU Bash Exit Status ↗.