rempug 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,20 +1,89 @@
1
1
  # rempug
2
2
 
3
- Delegasi kerja dari satu agent **orkestrator** (mis. Claude Code) ke agent CLI lain (Codex, Antigravity, opencode, Claude) yang berjalan di sesi **tmux**. Hemat token, terverifikasi mesin, dan tanpa file sampah di proyek.
3
+ [![CI](https://github.com/dianramdhani/rempug/actions/workflows/release.yml/badge.svg)](https://github.com/dianramdhani/rempug/actions/workflows/release.yml)
4
+ [![npm](https://img.shields.io/npm/v/rempug)](https://www.npmjs.com/package/rempug)
5
+ [![lisensi](https://img.shields.io/npm/l/rempug)](LICENSE)
4
6
 
5
- Anda hanya mengetik `/rempug` sekali. Sesudah itu orkestrator mendelegasikan, menunggu, memverifikasi, mengulang, dan mengalihkan pekerjaan sendiri; Anda hanya menilai apakah hasil yang Anda minta sudah benar.
7
+ **Bagi pekerjaan ke banyak agent AI di tmux tanpa membakar token, tanpa dibohongi, dan tanpa Anda jadi kurir.**
6
8
 
7
- ## Kenapa
9
+ Anda punya Claude Code, Codex, Antigravity, atau opencode. Masing-masing jalan di terminal, dan langganannya hanya bisa dipakai lewat CLI, bukan API. Anda ingin satu agent memimpin dan yang lain bekerja paralel. rempug adalah jembatannya: satu perintah `/rempug` di orkestrator, lalu Anda hanya menilai apakah hasilnya benar.
8
10
 
9
- - Membaca layar tmux mentah boros token dan rawan salah baca. Hasil kerja kembali lewat **perintah**, bukan lewat scrape layar.
10
- - Agent berupa model murah, jadi klaim mereka tidak dipercaya. **rempug menghitung sendiri** file yang berubah, menjalankan cek penerimaan, dan mendeteksi commit diam-diam.
11
- - Orkestrator tidak perlu diingatkan: `rempug watch` mendorong satu baris per kejadian, dengan kursor yang tersimpan sehingga tidak ada kejadian yang hilang.
12
- - Semua status disimpan di satu berkas SQLite di luar repo. Tidak ada `tasks/`, `state/`, atau `evidence/` di proyek Anda.
11
+ ## Kendala yang dihadapi siapa pun yang mencobanya
12
+
13
+ Siapa pun yang pernah menyuruh satu agent "tolong minta agent lain mengerjakan ini" akan bertemu masalah yang sama:
14
+
15
+ | Kendala | Yang sebenarnya terjadi |
16
+ |---|---|
17
+ | **Anda jadi kurir** | Menyalin tugas dari satu terminal ke terminal lain, lalu membawa hasilnya kembali. Orkestrator hanya mengelola, Anda yang mengangkut. |
18
+ | **Membaca layar tmux itu boros dan rapuh** | `capture-pane` mengembalikan kotak, garis, spinner, dan riwayat. Orkestrator membayar token untuk membaca noise, lalu masih bisa salah tafsir. |
19
+ | **Perintah "terkirim" belum tentu sampai** | Tiap TUI beda: ada yang menelan Enter pertama, ada yang hanya menerima paste, ada yang menahan teks di kotak input. Tugas diam-diam nyangkut. |
20
+ | **Agent murah suka mengaku selesai** | "Sudah beres!" padahal tes gagal, file lain ikut berubah, atau ada commit yang tidak diminta. Memeriksanya satu per satu memakan waktu dan token. |
21
+ | **Orkestrator tidak tahu agent sudah selesai** | Anda yang harus mengingatkan: "itu agent sudah selesai, coba cek". Anda jadi alarm. |
22
+ | **Dua agent menimpa file yang sama** | Satu working tree, dua agent, tanpa pagar. |
23
+ | **Skrip koordinasi buatan sendiri menumpuk sampah** | Ratusan berkas `tasks/`, `state/`, `evidence/` di repo, hanya dimengerti agent, ikut ter-commit. |
24
+
25
+ ## Cara rempug menyelesaikannya
26
+
27
+ | Tanpa rempug | Dengan rempug |
28
+ |---|---|
29
+ | Anda menyalin tugas ke tiap terminal | Orkestrator mengirim tugas sendiri: **satu baris** diketik ke agent, isi lengkapnya dibaca agent lewat perintah |
30
+ | Orkestrator membaca layar mentah | Hasil kembali lewat **perintah**, dan orkestrator hanya menerima **satu baris per kejadian** |
31
+ | Cara kirim ditebak, lalu nyangkut | Tiap agent **diukur** dulu (probe): teknik kirim mana yang benar-benar sampai |
32
+ | Percaya pengakuan agent | rempug **menghitung sendiri**: berkas yang berubah, hasil tes, commit diam-diam |
33
+ | Anda mengingatkan orkestrator | Kejadian **didorong** ke orkestrator, dengan kursor tersimpan sehingga tidak ada yang terlewat |
34
+ | Dua agent bentrok | Tugas yang cakupan berkasnya beririsan **ditolak** sebelum dikirim |
35
+ | Berkas koordinasi di repo | Semua di **satu berkas SQLite di luar repo**. Repo Anda tidak disentuh |
36
+ | Laporan penuh kode tugas dan istilah teknis | Laporan ke Anda **berupa kalimat biasa** |
37
+
38
+ Anda hanya mengetik `/rempug` sekali. Sesudahnya orkestrator memutuskan sendiri apa yang dibagi, menunggu, memeriksa, mengulang, dan memindahkan pekerjaan kalau agent bermasalah.
39
+
40
+ ## Cara kerja
41
+
42
+ Gambaran besarnya:
43
+
44
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/gambaran-besar.png" alt="Gambaran besar: Anda berbicara dengan orkestrator, orkestrator mengirim tugas lewat tmux ke agent codex, agy, dan opencode, hasilnya masuk ke ledger rempug, diverifikasi mesin, lalu satu baris hasil kembali ke orkestrator dan laporan kalimat biasa kembali ke Anda" width="480"></p>
45
+
46
+ Satu tugas dari awal sampai akhir. Perhatikan bahwa agent **tidak pernah dipercaya** sampai rempug memeriksanya sendiri:
47
+
48
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/satu-tugas.png" alt="Satu tugas dari awal sampai akhir: send, validasi, pointer, brief, paham, bekerja, reply, verifikasi oleh mesin, dan satu baris hasil lewat watch" width="640"></p>
49
+
50
+ Bila ada yang tidak beres, orkestrator naik tangga ini dan baru melibatkan Anda di akhir:
51
+
52
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/tangga-masalah.png" alt="Tangga penanganan masalah: kirim ulang maksimal 2 kali, pindah ke agent lain, lalu orkestrator mengerjakan sendiri; bila butuh izin manusia, Anda diberi tahu satu kalimat" width="480"></p>
53
+
54
+ **Prompt izin tidak pernah dijawab otomatis.** Kalau sebuah agent menunggu persetujuan, rempug hanya melaporkannya kepada Anda.
55
+
56
+ ### Yang dilakukan rempug di balik layar
57
+
58
+ - **Probe saat `/rempug`**: mengirim tugas uji ke tiap agent dan mengukur teknik kirim yang sampai, waktu respons, dan seperti apa layarnya saat sibuk. Agent yang gagal ditandai `tidak-andal` dan tidak dipakai.
59
+ - **Konfirmasi pemahaman**: agent harus menyebut cakupan, cek, dan rencananya dulu. Kalau cocok dengan brief, disetujui mesin tanpa token orkestrator. Kalau menyimpang (misalnya rencananya menyentuh `package.json`), ditahan.
60
+ - **Verifikasi oleh mesin**: berkas yang berubah beserta jumlah barisnya, perubahan di luar cakupan (hanya nama berkas, karena bisa jadi edit Anda sendiri), cek penerimaan yang dijalankan rempug, dan commit atau pindah branch.
61
+ - **Pemantau layar**: mengulang pengiriman yang tertahan, melaporkan pertanyaan, prompt izin, dan kuota habis, mengirim satu pengingat, lalu menyatakan agent macet.
62
+
63
+ ## Contoh hasil
64
+
65
+ Satu baris per tugas, yang dibaca orkestrator (nilainya contoh, bentuknya nyata):
66
+
67
+ ```
68
+ T12 codex ✓ 1 file +3/−1 | scope OK | tsc ✓ biome ✓
69
+ T13 agy ⚠ pelanggaran: HEAD berubah (a1b2c3d→e4f5a6b)
70
+ ```
71
+
72
+ Yang sampai kepada Anda, dalam kalimat biasa (`rempug report --manusia`):
73
+
74
+ ```
75
+ Selesai (1)
76
+ - Ubah kolom tabel Devices (oleh codex): mengubah 1 berkas (3 baris ditambah, 1 dihapus); semua pengecekan lulus
77
+
78
+ Perlu perhatian (1)
79
+ - Ubah tema (oleh agy): mengubah riwayat git tanpa izin (membuat commit atau berpindah cabang); hasilnya tidak dipercaya
80
+ ```
13
81
 
14
82
  ## Kebutuhan
15
83
 
16
84
  - Linux atau macOS (butuh `tmux`)
17
85
  - Node.js 22.13 atau lebih baru (memakai `node:sqlite` bawaan, tanpa dependensi native)
86
+ - Agent pekerja yang bisa menjalankan perintah shell (Codex, Antigravity, opencode, dan sebagainya)
18
87
 
19
88
  ## Pemasangan
20
89
 
@@ -22,10 +91,10 @@ Anda hanya mengetik `/rempug` sekali. Sesudah itu orkestrator mendelegasikan, me
22
91
  npm i -g rempug
23
92
  ```
24
93
 
25
- Perintah `rempug` harus ada di PATH: hook sesi dan agent yang Anda delegasikan memanggilnya dari shell (`rempug doctor` memeriksanya). Lalu pasang skill dan server MCP untuk Claude Code, salah satunya:
94
+ Perintah `rempug` harus ada di PATH: hook sesi dan agent pekerja memanggilnya dari shell (`rempug doctor` memeriksanya). Lalu pasang skill dan server MCP untuk Claude Code. **Pilih salah satu, bukan keduanya:**
26
95
 
27
96
  ```bash
28
- # A. Plugin: skill /rempug + server MCP + hook awal sesi sekaligus
97
+ # A. Plugin: skill /rempug + server MCP + hook awal sesi, sekaligus
29
98
  claude plugin marketplace add dianramdhani/rempug
30
99
  claude plugin install rempug@rempug
31
100
 
@@ -34,40 +103,51 @@ rempug skill install
34
103
  claude mcp add --scope user rempug -- rempug mcp
35
104
  ```
36
105
 
37
- Pasang salah satu saja, bukan keduanya. Mulai sesi Claude Code yang baru agar skill `/rempug` dan tool MCP-nya dimuat. Biaya tetap plugin sekitar 74 token per sesi; skema tool MCP baru dimuat penuh saat dipakai.
106
+ `rempug skill install` hanya menyalin satu berkas petunjuk ke `~/.claude/skills/rempug/`. Itu yang membuat Claude tahu kapan dan bagaimana memakai rempug, dan yang membuat `/rempug` dikenali. Letaknya di tingkat user, jadi berlaku untuk semua proyek dan **tidak ada yang ditulis ke repo Anda**. Mulai sesi Claude Code yang baru bila `/rempug` belum muncul. Biaya tetap plugin sekitar 74 token per sesi (angka dari `claude plugin details`).
38
107
 
39
108
  ## Pemakaian
40
109
 
41
- Siapkan sesi tmux dan jalankan agent di dalamnya (beserta apa pun yang perlu disiapkan, mis. sesi Playwright), lalu di orkestrator:
110
+ Siapkan sesi tmux dan jalankan agent di dalamnya, beserta apa pun yang perlu disiapkan (misalnya sesi Playwright). Lalu di orkestrator:
42
111
 
43
112
  ```
44
113
  /rempug
45
114
  ```
46
115
 
47
- Orkestrator memindai tmux, menebak mana yang agent, bertanya **satu kali** untuk penamaan, lalu **mengukur** tiap agent (probe) dan menampilkan tabel kesiapan:
116
+ Orkestrator memindai tmux, menebak mana yang agent, bertanya **satu kali** untuk penamaan, lalu menguji tiap agent dan menampilkan kesiapannya, misalnya:
48
117
 
49
118
  ```
50
- agy ✓ siap ack 1.8 dtk
51
- codex ✓ siap ack 2.4 dtk
52
- opencode ✗ tidak-andal teks tertahan di kotak input; 7 kombinasi dicoba
119
+ agy ✓ siap ack 5.7 dtk
120
+ codex ✓ siap ack 6.1 dtk
121
+ opencode ✗ tidak-andal agent melaporkan galat (limit, kuota, atau autentikasi)
53
122
  ```
54
123
 
55
- Sesudahnya Anda cukup meminta hasil. Orkestrator memutuskan sendiri apa yang dibagi ke agent dan hanya melaporkan hasilnya: tujuan tercapai atau belum, bukti yang menentukan, dan keputusan yang butuh Anda. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
124
+ Sesudah itu Anda cukup meminta hasil. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
56
125
 
57
- ## Cara kerja
126
+ ## Status pengujian: yang sudah dan belum
127
+
128
+ | | Status |
129
+ |---|---|
130
+ | 247 uji otomatis, termasuk uji ujung ke ujung dengan tmux dan git nyata | Lulus di CI: Ubuntu (Node 22.13, 24, 26) dan macOS (Node 24) |
131
+ | **Claude Code sebagai orkestrator** | **Diuji dan dipakai** |
132
+ | Codex dan Antigravity sebagai **pekerja** | Diuji dengan agent asli: lulus probe, dan dua tugas edit paralel selesai dan terverifikasi |
133
+ | opencode sebagai pekerja | Pengiriman berhasil, tetapi saat uji akunnya gagal login (galat 401), jadi alurnya belum terbukti |
134
+ | **Codex, Antigravity, atau opencode sebagai orkestrator** | **Belum dicoba** |
135
+ | Claude sebagai pekerja | Belum dicoba |
136
+
137
+ ### Orkestrator selain Claude Code
138
+
139
+ **Belum dicoba.** Perintah `rempug` dan server MCP-nya mengikuti standar sehingga bisa jadi berfungsi di orkestrator lain, tetapi bagian yang paling terikat ke Claude Code belum punya padanan teruji:
58
140
 
59
- 1. `send` memvalidasi **brief** (TUJUAN, CAKUPAN, LANGKAH, CEK, BALASAN), menolak cakupan yang beririsan dengan tugas edit lain, mengambil snapshot berkas, lalu mengetik **satu baris pointer** ke pane agent.
60
- 2. Agent menjalankan `rempug brief` (ini bukti pengiriman), mengonfirmasi pemahaman lewat `rempug paham`, bekerja, lalu `rempug reply`. Konfirmasi yang cocok dengan brief disetujui otomatis tanpa token orkestrator.
61
- 3. Verifikasi berjalan di proses terlepas: berkas yang berubah (+/−), perubahan di luar cakupan (hanya nama), cek penerimaan yang dijalankan rempug sendiri, dan commit atau pindah branch.
62
- 4. `watch` mencetak satu baris, mis. `T12 codex ✓ 3 file +41/−7 | scope OK | tsc ✓ vitest ✗(2)`.
141
+ - skill `/rempug`, plugin, dan hook sesi adalah format Claude Code;
142
+ - orkestrator dibangunkan lewat tool `Monitor` milik Claude Code. Untuk yang lain ada cadangan (`rempug watch --bangun`) yang mengetik satu baris ke layar orkestrator saat layarnya diam, tetapi baru diuji dengan tiruan, bukan dengan agent sungguhan.
63
143
 
64
- Pemantau layar berjalan di dalam `watch`: mengulang pengiriman yang tertahan, melaporkan pertanyaan, prompt izin, dan limit, mengirim satu pengingat, lalu menyatakan agent macet. **Prompt izin tidak pernah dijawab otomatis.**
144
+ Kalau Anda mencobanya dengan orkestrator lain, hasilnya sangat berguna: silakan buka issue.
65
145
 
66
146
  ## Perintah
67
147
 
68
148
  Untuk orkestrator: `scan`, `register`, `probe`, `ls`, `status`, `doctor`, `send`, `jawab`, `log`, `show`, `diff`, `report`, `layar`, `watch`, `terima`.
69
- Untuk agent: `brief`, `paham`, `tunggu`, `reply`.
70
- Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalankan `rempug --help` untuk pemakaian lengkap.
149
+ Untuk agent pekerja: `brief`, `paham`, `tunggu`, `reply`.
150
+ Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalankan `rempug --help` untuk pemakaian lengkap. `rempug report --manusia` menghasilkan laporan berkalimat biasa, tanpa kode tugas dan simbol.
71
151
 
72
152
  ## Konfigurasi
73
153
 
@@ -85,9 +165,12 @@ Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalanka
85
165
 
86
166
  ## Batasan yang perlu diketahui
87
167
 
88
- - **Deteksi keadaan layar bersifat heuristik** (teks tertahan, pertanyaan, prompt izin, limit). Ia teruji terhadap TUI palsu yang meniru perilaku berbeda, tetapi belum divalidasi terhadap setiap TUI sungguhan. Agent yang gagal probe ditandai `tidak-andal` dan tidak dipakai.
89
- - Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada TUJUAN. Untuk tugas berisiko gunakan `--teliti`; verifikasi sesudah kerja tetap menjadi jaring terakhir.
90
- - Pengecekan cakupan sengaja **konservatif**: path tanpa wildcard dianggap sebagai dirinya sendiri beserta isinya.
168
+ - **Deteksi keadaan layar bersifat heuristik** (teks tertahan, pertanyaan, prompt izin, kuota). Ia teruji terhadap TUI palsu yang meniru perilaku berbeda dan terhadap Codex dan Antigravity asli, tetapi belum divalidasi untuk setiap TUI. Agent yang gagal probe tidak dipakai.
169
+ - Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada tujuan. Untuk tugas berisiko gunakan `--teliti`; verifikasi sesudah kerja tetap menjadi jaring terakhir.
170
+ - Pengecekan cakupan sengaja **konservatif**: path tanpa wildcard dianggap sebagai dirinya sendiri beserta isinya. Kadang ia menolak tugas yang sebenarnya aman, demi tidak membiarkan dua agent menimpa file yang sama.
171
+ - Pada tugas `baca` dan `browser`, kolom `CEK` adalah deskripsi bukti yang harus dilaporkan agent, bukan perintah yang dijalankan. Perintah shell hanya dijalankan untuk tugas `edit`.
172
+ - Beberapa agent berbagi satu working tree dan branch. Commit Anda atau orkestrator saat tugas berjalan hanya menjadi **peringatan**; yang dianggap pelanggaran adalah pindah branch, menulis ulang riwayat, atau commit yang mengubah berkas di cakupan tugas itu sendiri.
173
+ - Pemeriksaan rencana hanya membatasi **penulisan** di luar cakupan. Menyebut berkas lain untuk dibaca (misalnya tugas audit) tidak menahan tugas. Pemeriksaan perubahan nyata setelah tugas selesai tetap menjadi jaring terakhir.
91
174
  - Windows tidak didukung (tmux).
92
175
 
93
176
  ## Pengembangan
@@ -99,7 +182,7 @@ npm run typecheck
99
182
  npm test # butuh tmux; termasuk uji ujung ke ujung
100
183
  ```
101
184
 
102
- Commit mengikuti [Conventional Commits](https://www.conventionalcommits.org/); versi, `CHANGELOG.md`, GitHub Release, dan publish npm dihasilkan otomatis oleh semantic-release dari cabang `main`.
185
+ Commit mengikuti [Conventional Commits](https://www.conventionalcommits.org/). Versi, `CHANGELOG.md`, GitHub Release, dan publish npm dihasilkan otomatis oleh semantic-release dari cabang `main`.
103
186
 
104
187
  ## Lisensi
105
188
 
@@ -33,3 +33,18 @@ export function gitFiles(repo, pathspecs) {
33
33
  ]);
34
34
  return out ? out.split("\0").filter(Boolean) : [];
35
35
  }
36
+ /** Apakah `ancestor` adalah leluhur `descendant` (HEAD yang hanya maju, bukan ditulis ulang). */
37
+ export function isAncestor(repo, ancestor, descendant) {
38
+ return (spawnSync("git", ["-C", repo, "merge-base", "--is-ancestor", ancestor, descendant], {
39
+ encoding: "utf8",
40
+ }).status === 0);
41
+ }
42
+ /** Jumlah commit yang ada di `to` tetapi tidak di `from`. */
43
+ export function commitsBetween(repo, from, to) {
44
+ return (Number(git(repo, ["rev-list", "--count", `${from}..${to}`])?.trim()) || 0);
45
+ }
46
+ /** Berkas yang berbeda antara dua commit. */
47
+ export function changedFilesBetween(repo, from, to) {
48
+ const out = git(repo, ["diff", "--name-only", "-z", from, to]);
49
+ return out ? out.split("\0").filter(Boolean) : [];
50
+ }
@@ -1,3 +1,5 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join } from "node:path";
1
3
  import { parseBrief } from "./brief.js";
2
4
  import { RempugError, UsageError } from "./errors.js";
3
5
  import { PROFIL_BAWAAN } from "./profile.js";
@@ -20,15 +22,60 @@ const baris = (teks) => teks
20
22
  .split("\n")
21
23
  .map((l) => l.trim())
22
24
  .filter(Boolean);
23
- /** Path yang disebut di teks: token yang memuat `/` atau berakhiran ekstensi, bukan URL atau opsi. */
24
- function pathDisebut(teks) {
25
+ /** Kata kerja yang mengubah isi berkas. Menyebut berkas untuk dibaca atau diperiksa tidak dihitung. */
26
+ const KATA_TULIS = /\b(ubah|mengubah|diubah|edit|mengedit|diedit|tulis|menulis|ditulis|hapus|menghapus|dihapus|buat|membuat|dibuat|tambah|menambah|menambahkan|ditambah|ganti|mengganti|diganti|rename|pindah|memindahkan|dipindah|modifikasi|memodifikasi|perbarui|memperbarui|update|write|create|delete|remove|modify|change|replace|overwrite|move|patch|append)\b/i;
27
+ /**
28
+ * Memecah rencana menjadi butir: per baris, dan per penomoran dalam satu baris ("1) a 2) b 3) c").
29
+ * Model murah sering menulis seluruh rencana dalam satu baris.
30
+ */
31
+ function butirRencana(teks) {
32
+ return teks
33
+ .split("\n")
34
+ .flatMap((l) => l.split(/(?:^|\s)\d+[.)]\s+/))
35
+ .map((b) => b.trim().replace(/^[-*•]\s+/, ""))
36
+ .filter(Boolean);
37
+ }
38
+ /** `a/{b,c}/d` menjadi `a/b/d` dan `a/c/d`. */
39
+ function kembangkanKurung(token) {
40
+ const cocok = /\{([^{}]*)\}/.exec(token);
41
+ if (!cocok)
42
+ return [token];
43
+ const depan = token.slice(0, cocok.index);
44
+ const belakang = token.slice(cocok.index + cocok[0].length);
45
+ return (cocok[1] ?? "")
46
+ .split(",")
47
+ .flatMap((pilihan) => kembangkanKurung(`${depan}${pilihan.trim()}${belakang}`));
48
+ }
49
+ /**
50
+ * Path yang disebut di teks. Token dianggap path bila berekstensi, atau memuat `/` dan benar-benar ada di repo.
51
+ * Kata biasa seperti "laporan/checkpoint" atau "docs" tidak dihitung; yang terlewat tertangkap oleh
52
+ * pemeriksaan perubahan nyata setelah tugas selesai.
53
+ */
54
+ function pathDisebut(teks, repo) {
25
55
  return teks
26
- .split(/[\s`'"(),;:]+/)
56
+ .split(/[\s`'"()]+/)
57
+ .flatMap(kembangkanKurung)
58
+ .flatMap((t) => t.split(/[,;:]+/))
27
59
  .map((t) => t.replace(/\.+$/, ""))
28
60
  .filter((t) => t !== "" &&
29
61
  !t.startsWith("-") &&
62
+ !t.startsWith("*") &&
30
63
  !t.includes("://") &&
31
- (t.includes("/") || /\.[a-z][a-z0-9]{1,4}$/i.test(t)));
64
+ (/\.[a-z][a-z0-9]{1,4}$/i.test(t) ||
65
+ (t.includes("/") && existsSync(join(repo, t)))));
66
+ }
67
+ /** Perintah tanpa penghias: tanpa backtick, bullet, nomor, atau prompt `$`, dengan spasi dirapikan. */
68
+ const bersihkanPerintah = (teks) => teks
69
+ .replace(/`/g, "")
70
+ .replace(/^\s*(?:\d+[.)]|[-*•]|\$)\s+/, "")
71
+ .replace(/\s+/g, " ")
72
+ .trim();
73
+ /** Perintah brief yang tidak disebut di CEK agent; urutan, format, dan perintah tambahan dari agent diabaikan. */
74
+ function cekYangHilang(cekAgent, cekBrief) {
75
+ const tumpukan = kosong(cekAgent)
76
+ ? ""
77
+ : (cekAgent ?? "").split("\n").map(bersihkanPerintah).join("\n");
78
+ return cekBrief.filter((perintah) => !tumpukan.includes(bersihkanPerintah(perintah)));
32
79
  }
33
80
  const potong = (teks, panjang) => teks.length > panjang ? `${teks.slice(0, panjang - 1)}…` : teks;
34
81
  /** Alasan konfirmasi pemahaman tidak boleh disetujui otomatis; kosong berarti cocok. */
@@ -43,14 +90,20 @@ function bandingkan(task, bagian) {
43
90
  cakupan.shift();
44
91
  if (!sama(cakupan.map(normalisasi), scope.map(normalisasi)))
45
92
  alasan.push(`cakupan berbeda dari brief (agent: ${cakupan.join(", ") || "-"}; brief: ${scope.join(", ")})`);
46
- const cek = kosong(bagian.get("CEK")) ? [] : baris(bagian.get("CEK") ?? "");
47
- if (!sama(cek, parsed.brief.cek))
48
- alasan.push("cek berbeda dari brief");
93
+ const hilang = cekYangHilang(bagian.get("CEK"), parsed.brief.cek);
94
+ if (hilang.length > 0)
95
+ alasan.push(`cek berbeda dari brief (tidak disebut: ${hilang.join(", ")})`);
49
96
  const rencanaTeks = bagian.get("RENCANA") ?? "";
50
- const rencana = baris(rencanaTeks).map((l) => l.replace(/^(\d+[.)]|[-*•])\s+/, ""));
97
+ const rencana = butirRencana(rencanaTeks);
51
98
  if (rencana.length > MAKS_BUTIR)
52
99
  alasan.push(`rencana lebih dari ${MAKS_BUTIR} butir (${rencana.length})`);
53
- const luar = pathDisebut(rencanaTeks).filter((p) => !covers(scope, p));
100
+ // Hanya butir yang menulis yang dibatasi cakupan; membaca berkas di luar cakupan itu wajar (mis. audit).
101
+ const luar = [
102
+ ...new Set(rencana
103
+ .filter((butir) => KATA_TULIS.test(butir))
104
+ .flatMap((butir) => pathDisebut(butir, task.repo))
105
+ .filter((p) => !covers(scope, p))),
106
+ ];
54
107
  if (luar.length > 0)
55
108
  alasan.push(`rencana menyentuh di luar cakupan: ${luar.join(", ")}`);
56
109
  const terlarang = TERLARANG.exec(`${rencanaTeks}\n${bagian.get("ASUMSI") ?? ""}`);
@@ -146,6 +146,8 @@ function uraianTugas(task) {
146
146
  const bagian = hasil
147
147
  ? [uraianPerubahan(hasil), uraianCek(hasil)]
148
148
  : ["selesai"];
149
+ if (hasil?.peringatan)
150
+ bagian.push("juga ada commit lain di repo selama tugas berjalan (bukan dari tugas ini)");
149
151
  if (hasil?.luarCakupan.length)
150
152
  bagian.push(`juga ada perubahan di luar area tugas: ${hasil.luarCakupan.slice(0, 4).join(", ")}`);
151
153
  return bagian.filter(Boolean).join("; ");
@@ -6,7 +6,7 @@ import { basename, join } from "node:path";
6
6
  import { deflateSync, inflateSync } from "node:zlib";
7
7
  import { parseBrief } from "./brief.js";
8
8
  import { RempugError } from "./errors.js";
9
- import { gitFiles, gitInfo, isGitRepo } from "./git.js";
9
+ import { changedFilesBetween, commitsBetween, gitFiles, gitInfo, isAncestor, isGitRepo, } from "./git.js";
10
10
  import { covers } from "./scope.js";
11
11
  /** Berkas di atas ukuran ini hanya disimpan hash-nya, tanpa isi. */
12
12
  const BATAS_BERKAS = 1024 * 1024;
@@ -262,9 +262,35 @@ export function formatLine(task, hasil) {
262
262
  const akhir = [
263
263
  ...(cek.length ? [cek.join(" ")] : []),
264
264
  ...(hasil.tanpaPaham ? ["⚠ tanpa paham"] : []),
265
+ ...(hasil.peringatan ? [`ℹ ${hasil.peringatan}`] : []),
265
266
  ];
266
267
  return [dasar, ...akhir].join(" | ");
267
268
  }
269
+ /**
270
+ * Membedakan commit agent dari commit orang lain. Beberapa agent berbagi satu working tree, jadi user atau
271
+ * orkestrator bisa commit di tengah tugas; HEAD yang hanya maju dan tidak menyentuh berkas tugas ini adalah
272
+ * peringatan, bukan pelanggaran. Pelanggaran: pindah branch, riwayat ditulis ulang, atau commit baru yang
273
+ * mengubah berkas di cakupan tugas ini (agent yang commit pekerjaannya sendiri).
274
+ */
275
+ function periksaGit(task, git) {
276
+ if (task.branch && git.branch && task.branch !== git.branch)
277
+ return { pelanggaran: `branch berubah (${task.branch}→${git.branch})` };
278
+ if (!task.headSha || !git.head || task.headSha === git.head)
279
+ return {};
280
+ if (!isAncestor(task.repo, task.headSha, git.head))
281
+ return {
282
+ pelanggaran: `riwayat git ditulis ulang (HEAD ${pendek(git.head)} bukan lanjutan dari ${pendek(task.headSha)})`,
283
+ };
284
+ const dalam = changedFilesBetween(task.repo, task.headSha, git.head).filter((f) => covers(task.scope ?? [], f));
285
+ if (dalam.length > 0)
286
+ return {
287
+ pelanggaran: `commit baru mengubah berkas di cakupan tugas (${pendek(task.headSha)}→${pendek(git.head)}): ${dalam.slice(0, 3).join(", ")}`,
288
+ };
289
+ const n = commitsBetween(task.repo, task.headSha, git.head);
290
+ return {
291
+ peringatan: `HEAD maju ${n} commit selama tugas, di luar cakupan tugas ini`,
292
+ };
293
+ }
268
294
  /**
269
295
  * Memverifikasi tugas yang sudah dibalas agent: perubahan berkas, cek penerimaan, dan commit.
270
296
  * Mengubah status menjadi selesai, gagal, atau pelanggaran, dan menulis satu event.
@@ -281,16 +307,13 @@ export function verifyTask(ledger, id, options = {}) {
281
307
  const cek = parsed.ok && task.mode === "edit" ? parsed.brief.cek : [];
282
308
  const edit = task.mode === "edit";
283
309
  const git = gitInfo(task.repo);
284
- let pelanggaran;
285
- if (task.headSha && git.head && task.headSha !== git.head)
286
- pelanggaran = `HEAD berubah (${pendek(task.headSha)}→${pendek(git.head)})`;
287
- else if (task.branch && git.branch && task.branch !== git.branch)
288
- pelanggaran = `branch berubah (${task.branch}→${git.branch})`;
310
+ const { pelanggaran, peringatan } = periksaGit(task, git);
289
311
  const perubahan = edit ? computeChanges(ledger, task, task.repo) : [];
290
312
  const hasilCek = runChecks(cek, task.repo, options.waktuCekMs);
291
313
  const hasil = {
292
314
  ok: !pelanggaran && hasilCek.every((c) => c.ok),
293
315
  pelanggaran,
316
+ peringatan,
294
317
  perubahan,
295
318
  plus: perubahan.reduce((n, f) => n + f.plus, 0),
296
319
  minus: perubahan.reduce((n, f) => n + f.minus, 0),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rempug",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Distribusi kerja dari agent orkestrator ke agent CLI lain lewat tmux, hemat token.",
5
5
  "keywords": [
6
6
  "agent",
@@ -62,7 +62,8 @@ Agent adalah model murah: tulis brief selengkap dan sejelas mungkin, karena biay
62
62
  | `bertanya` | Jawab dengan `jawab <id> "..."` |
63
63
  | `menunggu-izin` | Manusia yang harus bertindak: satu kalimat berisi sesi dan tindakan, lalu lanjutkan pekerjaan lain |
64
64
  | `limit`, `macet`, `tersangkut`, `hilang` | Alihkan ke agent lain atau kerjakan sendiri |
65
- | `pelanggaran` | HEAD atau branch berubah: hentikan, laporkan ke user, jangan menumpuk tugas di atasnya |
65
+ | `pelanggaran` | Agent berpindah branch, menulis ulang riwayat, atau commit berkas di cakupan tugasnya sendiri: hentikan, laporkan ke user, jangan menumpuk tugas di atasnya |
66
+ | `ℹ HEAD maju N commit ... di luar cakupan tugas ini` | Bukan pelanggaran: commit user atau orkestrator saat tugas berjalan (beberapa agent berbagi satu working tree). Abaikan; hasil tugas tetap dinilai dari tes dan perubahannya |
66
67
  | `diterima-tanpa-ack` | Agent menerima pointer tetapi tidak menjalankan rempug; alihkan |
67
68
 
68
69
  ### Kebijakan peninjauan