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 +111 -28
- package/dist/src/core/git.js +15 -0
- package/dist/src/core/paham.js +62 -9
- package/dist/src/core/report.js +2 -0
- package/dist/src/core/verify.js +29 -6
- package/package.json +1 -1
- package/skills/rempug/SKILL.md +2 -1
package/README.md
CHANGED
|
@@ -1,20 +1,89 @@
|
|
|
1
1
|
# rempug
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://github.com/dianramdhani/rempug/actions/workflows/release.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/rempug)
|
|
5
|
+
[](LICENSE)
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
**Bagi pekerjaan ke banyak agent AI di tmux tanpa membakar token, tanpa dibohongi, dan tanpa Anda jadi kurir.**
|
|
6
8
|
|
|
7
|
-
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
51
|
-
codex ✓ siap ack
|
|
52
|
-
opencode ✗ tidak-andal
|
|
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
|
-
|
|
124
|
+
Sesudah itu Anda cukup meminta hasil. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
|
|
56
125
|
|
|
57
|
-
##
|
|
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
|
-
|
|
60
|
-
|
|
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
|
-
|
|
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,
|
|
89
|
-
- Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada
|
|
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/)
|
|
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
|
|
package/dist/src/core/git.js
CHANGED
|
@@ -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
|
+
}
|
package/dist/src/core/paham.js
CHANGED
|
@@ -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
|
-
/**
|
|
24
|
-
|
|
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
|
-
(
|
|
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
|
|
47
|
-
if (
|
|
48
|
-
alasan.push(
|
|
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 =
|
|
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
|
-
|
|
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") ?? ""}`);
|
package/dist/src/core/report.js
CHANGED
|
@@ -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("; ");
|
package/dist/src/core/verify.js
CHANGED
|
@@ -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
|
-
|
|
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
package/skills/rempug/SKILL.md
CHANGED
|
@@ -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`
|
|
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
|