rempug 0.1.0 → 0.1.2
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/.claude-plugin/marketplace.json +14 -0
- package/README.md +111 -30
- package/dist/src/commands.js +8 -3
- package/dist/src/core/report.js +110 -0
- package/dist/src/core/send.js +5 -0
- package/dist/src/core/verify.js +3 -1
- package/dist/src/mcp.js +2 -2
- package/package.json +1 -1
- package/skills/rempug/SKILL.md +27 -2
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "rempug",
|
|
3
|
+
"owner": {
|
|
4
|
+
"name": "dianramdhani"
|
|
5
|
+
},
|
|
6
|
+
"plugins": [
|
|
7
|
+
{
|
|
8
|
+
"name": "rempug",
|
|
9
|
+
"source": "./",
|
|
10
|
+
"description": "Delegasi kerja dari agent orkestrator ke agent CLI lain lewat tmux, hemat token dan terverifikasi mesin."
|
|
11
|
+
}
|
|
12
|
+
],
|
|
13
|
+
"description": "Plugin rempug: delegasi kerja ke agent CLI lain lewat tmux."
|
|
14
|
+
}
|
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,52 +91,63 @@ Anda hanya mengetik `/rempug` sekali. Sesudah itu orkestrator mendelegasikan, me
|
|
|
22
91
|
npm i -g rempug
|
|
23
92
|
```
|
|
24
93
|
|
|
25
|
-
Lalu pasang skill dan server MCP untuk Claude Code
|
|
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
|
-
# 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
|
-
claude plugin install rempug
|
|
99
|
+
claude plugin install rempug@rempug
|
|
31
100
|
|
|
32
|
-
#
|
|
101
|
+
# B. Manual
|
|
33
102
|
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,10 @@ 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`.
|
|
91
172
|
- Windows tidak didukung (tmux).
|
|
92
173
|
|
|
93
174
|
## Pengembangan
|
|
@@ -99,7 +180,7 @@ npm run typecheck
|
|
|
99
180
|
npm test # butuh tmux; termasuk uji ujung ke ujung
|
|
100
181
|
```
|
|
101
182
|
|
|
102
|
-
Commit mengikuti [Conventional Commits](https://www.conventionalcommits.org/)
|
|
183
|
+
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
184
|
|
|
104
185
|
## Lisensi
|
|
105
186
|
|
package/dist/src/commands.js
CHANGED
|
@@ -15,7 +15,7 @@ import { jawab, paham, tunggu } from "./core/paham.js";
|
|
|
15
15
|
import { formatProbe, isStale, probeAgent, versiAgent, } from "./core/probe.js";
|
|
16
16
|
import { readAgents, registryPath, removeAgent, updateAgent, } from "./core/registry.js";
|
|
17
17
|
import { reply } from "./core/reply.js";
|
|
18
|
-
import { barisLog, formatLaporan, formatLaporanMd, formatShow, } from "./core/report.js";
|
|
18
|
+
import { barisLog, formatLaporan, formatLaporanManusia, formatLaporanMd, formatShow, } from "./core/report.js";
|
|
19
19
|
import { scan } from "./core/scan.js";
|
|
20
20
|
import { KONSUMEN, pump, readBrief, sendTask, } from "./core/send.js";
|
|
21
21
|
import { tick } from "./core/tick.js";
|
|
@@ -274,13 +274,18 @@ const HANDLERS = {
|
|
|
274
274
|
: "tidak ada perubahan");
|
|
275
275
|
},
|
|
276
276
|
report(args, h) {
|
|
277
|
-
const { values } = argumen(args, {
|
|
277
|
+
const { values } = argumen(args, {
|
|
278
|
+
md: { type: "string" },
|
|
279
|
+
manusia: { type: "boolean" },
|
|
280
|
+
});
|
|
278
281
|
const tasks = h.ledger.listTasks(h.repo);
|
|
279
282
|
if (values.md) {
|
|
280
283
|
writeFileSync(values.md, formatLaporanMd(h.repo, tasks));
|
|
281
284
|
return void h.io.stdout(`laporan ditulis ke ${values.md}`);
|
|
282
285
|
}
|
|
283
|
-
h.io.stdout(
|
|
286
|
+
h.io.stdout(values.manusia
|
|
287
|
+
? formatLaporanManusia(tasks)
|
|
288
|
+
: formatLaporan(h.repo, tasks));
|
|
284
289
|
},
|
|
285
290
|
layar(args, h) {
|
|
286
291
|
const { values, positionals } = argumen(args, {
|
package/dist/src/core/report.js
CHANGED
|
@@ -94,3 +94,113 @@ export function formatLaporanMd(repo, tasks) {
|
|
|
94
94
|
bagian.push("Belum ada tugas.");
|
|
95
95
|
return `${bagian.join("\n\n")}\n`;
|
|
96
96
|
}
|
|
97
|
+
const POTONG = 140;
|
|
98
|
+
const potong = (teks) => teks.length > POTONG ? `${teks.slice(0, POTONG - 1)}…` : teks;
|
|
99
|
+
/** Baris pertama balasan agent tanpa label "HASIL:", dalam kata-kata agent sendiri. */
|
|
100
|
+
function inti(teks) {
|
|
101
|
+
const baris = (teks ?? "")
|
|
102
|
+
.split("\n")
|
|
103
|
+
.map((l) => l.trim().replace(/^(HASIL|RINGKASAN)\s*:\s*/i, ""))
|
|
104
|
+
.find(Boolean);
|
|
105
|
+
return baris ? potong(baris) : undefined;
|
|
106
|
+
}
|
|
107
|
+
function uraianPerubahan(hasil) {
|
|
108
|
+
const per = (st) => hasil.perubahan.filter((f) => f.status === st).length;
|
|
109
|
+
const bagian = [
|
|
110
|
+
[per("M"), (n) => `mengubah ${n} berkas`],
|
|
111
|
+
[per("A"), (n) => `menambah ${n} berkas baru`],
|
|
112
|
+
[per("D"), (n) => `menghapus ${n} berkas`],
|
|
113
|
+
]
|
|
114
|
+
.filter(([n]) => n > 0)
|
|
115
|
+
.map(([n, f]) => f(n));
|
|
116
|
+
if (bagian.length === 0)
|
|
117
|
+
return "tidak ada berkas yang berubah";
|
|
118
|
+
const kalimat = bagian.length === 1
|
|
119
|
+
? bagian[0]
|
|
120
|
+
: `${bagian.slice(0, -1).join(", ")}, dan ${bagian.at(-1)}`;
|
|
121
|
+
const garis = hasil.plus > 0 || hasil.minus > 0
|
|
122
|
+
? ` (${hasil.plus} baris ditambah, ${hasil.minus} dihapus)`
|
|
123
|
+
: "";
|
|
124
|
+
return `${kalimat}${garis}`;
|
|
125
|
+
}
|
|
126
|
+
function uraianCek(hasil) {
|
|
127
|
+
if (hasil.cek.length === 0)
|
|
128
|
+
return undefined;
|
|
129
|
+
const gagal = hasil.cek.filter((c) => !c.ok);
|
|
130
|
+
if (gagal.length === 0)
|
|
131
|
+
return "semua pengecekan lulus";
|
|
132
|
+
return gagal
|
|
133
|
+
.map((c) => c.timeout
|
|
134
|
+
? `pengecekan ${c.label} melewati batas waktu`
|
|
135
|
+
: c.gagal
|
|
136
|
+
? `pengecekan ${c.label} gagal (${c.gagal} masalah)`
|
|
137
|
+
: `pengecekan ${c.label} gagal`)
|
|
138
|
+
.join(", ");
|
|
139
|
+
}
|
|
140
|
+
function uraianTugas(task) {
|
|
141
|
+
const hasil = hasilVerifikasi(task);
|
|
142
|
+
switch (task.status) {
|
|
143
|
+
case "selesai": {
|
|
144
|
+
if (task.mode !== "edit")
|
|
145
|
+
return inti(task.replySummary) ?? "selesai";
|
|
146
|
+
const bagian = hasil
|
|
147
|
+
? [uraianPerubahan(hasil), uraianCek(hasil)]
|
|
148
|
+
: ["selesai"];
|
|
149
|
+
if (hasil?.luarCakupan.length)
|
|
150
|
+
bagian.push(`juga ada perubahan di luar area tugas: ${hasil.luarCakupan.slice(0, 4).join(", ")}`);
|
|
151
|
+
return bagian.filter(Boolean).join("; ");
|
|
152
|
+
}
|
|
153
|
+
case "gagal":
|
|
154
|
+
return ((hasil && uraianCek(hasil)) ||
|
|
155
|
+
inti(task.replySummary) ||
|
|
156
|
+
"tidak berhasil");
|
|
157
|
+
case "pelanggaran":
|
|
158
|
+
return "mengubah riwayat git tanpa izin (membuat commit atau berpindah cabang); hasilnya tidak dipercaya";
|
|
159
|
+
case "gagal-paham":
|
|
160
|
+
return "tidak memahami tugas setelah beberapa kali klarifikasi";
|
|
161
|
+
case "macet":
|
|
162
|
+
return "terhenti dan tidak merespons";
|
|
163
|
+
case "menunggu-klarifikasi":
|
|
164
|
+
return "menunggu jawaban atas pertanyaannya";
|
|
165
|
+
case "antri":
|
|
166
|
+
return "menunggu giliran";
|
|
167
|
+
default:
|
|
168
|
+
if (task.flag === "menunggu-izin")
|
|
169
|
+
return `menunggu persetujuan Anda di sesi ${task.agent}`;
|
|
170
|
+
if (task.flag === "bertanya")
|
|
171
|
+
return "mengajukan pertanyaan dan menunggu jawaban";
|
|
172
|
+
if (task.flag === "diterima-tanpa-ack")
|
|
173
|
+
return "menerima tugas tetapi belum mulai bekerja";
|
|
174
|
+
return "sedang dikerjakan";
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
function tujuanTugas(task) {
|
|
178
|
+
const tujuan = /^TUJUAN:[ \t]*(.+)$/m.exec(task.brief)?.[1]?.trim();
|
|
179
|
+
return tujuan ? tujuan.replace(/\s+/g, " ") : "tugas tanpa judul";
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* Laporan dalam kalimat biasa untuk manusia: tanpa ID tugas, simbol, atau istilah internal.
|
|
183
|
+
* Hanya nama agent (yang diberikan pengguna sendiri) dan kata-kata agent yang dipertahankan.
|
|
184
|
+
*/
|
|
185
|
+
export function formatLaporanManusia(tasks) {
|
|
186
|
+
if (tasks.length === 0)
|
|
187
|
+
return "Belum ada pekerjaan yang didelegasikan.";
|
|
188
|
+
const k = kelompok(tasks);
|
|
189
|
+
const bermasalah = [...new Set([...k.gagal, ...k.blocker])];
|
|
190
|
+
const berjalan = k.berjalan.filter((t) => !bermasalah.includes(t));
|
|
191
|
+
const bagian = [];
|
|
192
|
+
const tulis = (judul, daftar) => {
|
|
193
|
+
if (daftar.length === 0)
|
|
194
|
+
return;
|
|
195
|
+
const baris = daftar
|
|
196
|
+
.slice(0, MAKS_PER_KELOMPOK)
|
|
197
|
+
.map((t) => `- ${tujuanTugas(t)} (oleh ${t.agent}): ${uraianTugas(t)}`);
|
|
198
|
+
if (daftar.length > MAKS_PER_KELOMPOK)
|
|
199
|
+
baris.push(`- dan ${daftar.length - MAKS_PER_KELOMPOK} lainnya`);
|
|
200
|
+
bagian.push(`${judul} (${daftar.length})\n${baris.join("\n")}`);
|
|
201
|
+
};
|
|
202
|
+
tulis("Selesai", k.selesai);
|
|
203
|
+
tulis("Sedang berjalan", berjalan);
|
|
204
|
+
tulis("Perlu perhatian", bermasalah);
|
|
205
|
+
return bagian.join("\n\n");
|
|
206
|
+
}
|
package/dist/src/core/send.js
CHANGED
|
@@ -147,6 +147,11 @@ export function readBrief(ledger, id) {
|
|
|
147
147
|
]
|
|
148
148
|
: []),
|
|
149
149
|
"Kerjakan langkah-langkah di atas persis sesuai isinya.",
|
|
150
|
+
...(edit
|
|
151
|
+
? []
|
|
152
|
+
: [
|
|
153
|
+
"CEK untuk tugas ini adalah bukti yang harus kamu laporkan di BUKTI; tidak dijalankan sebagai perintah.",
|
|
154
|
+
]),
|
|
150
155
|
`Setelah selesai, balas dengan \`rempug reply T${id}\` (isi lewat stdin): HASIL, BUKTI, BLOCKER. Bila tidak bisa menyelesaikan: \`rempug reply T${id} --gagal\`.`,
|
|
151
156
|
];
|
|
152
157
|
return [
|
package/dist/src/core/verify.js
CHANGED
|
@@ -276,7 +276,9 @@ export function verifyTask(ledger, id, options = {}) {
|
|
|
276
276
|
if (task.status !== "memverifikasi")
|
|
277
277
|
throw new RempugError(`tugas T${id} berstatus ${task.status}; tidak sedang memverifikasi`);
|
|
278
278
|
const parsed = parseBrief(task.brief);
|
|
279
|
-
|
|
279
|
+
// CEK dijalankan sebagai perintah shell hanya untuk tugas edit. Pada tugas baca dan browser ia adalah
|
|
280
|
+
// deskripsi bukti yang harus dilaporkan agent; menjalankannya sebagai shell menggagalkan tugas yang benar.
|
|
281
|
+
const cek = parsed.ok && task.mode === "edit" ? parsed.brief.cek : [];
|
|
280
282
|
const edit = task.mode === "edit";
|
|
281
283
|
const git = gitInfo(task.repo);
|
|
282
284
|
let pelanggaran;
|
package/dist/src/mcp.js
CHANGED
|
@@ -104,8 +104,8 @@ export async function jalankanMcp(dasar, versi) {
|
|
|
104
104
|
alat("diff", "Daftar file yang berubah, atau hunk satu file bila `berkas` diberikan.", { id, berkas: z.string().optional() }, (a) => ({
|
|
105
105
|
argv: ["diff", String(a.id), ...(a.berkas ? [a.berkas] : [])],
|
|
106
106
|
}));
|
|
107
|
-
alat("report", "Laporan
|
|
108
|
-
argv: ["report", ...opsi("md", a.md)],
|
|
107
|
+
alat("report", "Laporan pekerjaan. Untuk menjawab MANUSIA selalu manusia=true (kalimat biasa tanpa ID atau simbol); tanpa itu keluarannya hanya untuk orkestrator. md menulis berkas Markdown.", { md: z.string().optional(), manusia: z.boolean().optional() }, (a) => ({
|
|
108
|
+
argv: ["report", ...opsi("md", a.md), ...bendera("manusia", a.manusia)],
|
|
109
109
|
}));
|
|
110
110
|
alat("layar", "Layar mentah pane agent; hanya bila benar-benar perlu.", { agent: z.string(), baris: z.number().int().positive().optional() }, (a) => ({
|
|
111
111
|
argv: ["layar", a.agent, ...opsi("baris", a.baris)],
|
package/package.json
CHANGED
package/skills/rempug/SKILL.md
CHANGED
|
@@ -46,6 +46,8 @@ yarn check
|
|
|
46
46
|
BALASAN: HASIL, BUKTI, BLOCKER
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
+
Pada tugas `baca` dan `browser`, `CEK` adalah deskripsi bukti yang harus dilaporkan agent (tidak dijalankan sebagai perintah); tulislah dengan kalimat biasa. Pada tugas `edit`, `CEK` adalah perintah shell yang dijalankan rempug.
|
|
50
|
+
|
|
49
51
|
Agent adalah model murah: tulis brief selengkap dan sejelas mungkin, karena biayanya kecil dibanding mengulang pekerjaan yang salah. Tugas `edit` wajib punya minimal satu CEK. Tambahkan `teliti` untuk tugas berisiko agar rencana agent selalu sampai padamu.
|
|
50
52
|
|
|
51
53
|
**Sebelum menunggu**, pastikan `watch` aktif. `send` memperingatkan bila tidak. Saat notifikasi kedaluwarsa Monitor datang dan masih ada tugas berjalan, pasang ulang segera.
|
|
@@ -67,9 +69,32 @@ Agent adalah model murah: tulis brief selengkap dan sejelas mungkin, karena biay
|
|
|
67
69
|
|
|
68
70
|
Jangan mempercayai klaim agent; baris verifikasi dihitung rempug sendiri. Tugas `baca` dan `browser`: cek acak atas ringkasan. Tugas `edit`: pegang baris verifikasi (`+/−`, `scope`, cek) dan baca `diff <id> <berkas>` hanya untuk file berisiko, bukan semuanya. `⚠ di luar` hanya nama file: bisa pelanggaran agent, bisa juga edit user, jadi jangan menuduh. `⚠ tanpa paham` berarti agent melewati konfirmasi pemahaman.
|
|
69
71
|
|
|
70
|
-
###
|
|
72
|
+
### Bahasa ke user (aturan keras)
|
|
73
|
+
|
|
74
|
+
Semua yang kamu tulis kepada user harus bisa dipahami orang yang **tidak tahu rempug ada**. ID tugas, simbol, dan istilah internal hanya untuk kamu dan para agent.
|
|
75
|
+
|
|
76
|
+
**Dilarang muncul di pesan ke user:**
|
|
77
|
+
|
|
78
|
+
- ID tugas (`T12`, "tugas 3"), dan nomor apa pun yang hanya bermakna di dalam rempug.
|
|
79
|
+
- Simbol status dan tanda baca teknis: `✓ ✗ ⚠ ⏱`, `+41/−7`, `-->`, `--flag`.
|
|
80
|
+
- Istilah internal: antrean, `--after`, `--queue`, `terima`, `watch`, `probe`, `ack`, `pointer`, `scope` atau cakupan, `CEK`, `paham`, `klarifikasi`, `kejadian`, nama tool (`browser_tabs`, `snapshot`), dan kata `delegasi` atau `didelegasikan`.
|
|
81
|
+
- Dugaan yang belum kamu periksa ("tampaknya berasal dari ...", "belum saya verifikasi"). Periksa dulu sendiri dengan `show <id> --penuh` dan `diff`, baru laporkan hasilnya.
|
|
82
|
+
- Cerita tentang caramu bekerja ("saya kirim tanpa antrean", "nanti saya ambil dengan terima").
|
|
83
|
+
|
|
84
|
+
**Yang boleh:** nama agent yang dipilih user (codex, agy), kata-kata biasa, dan nama berkas atau halaman yang dibicarakan.
|
|
85
|
+
|
|
86
|
+
Untuk menjawab user, ambil bahan dari `report` dengan `manusia=true` (CLI: `rempug report --manusia`). Keluarannya sudah berupa kalimat biasa. **Jangan menyalin keluaran `log`, `show`, `ls`, `status`, atau kejadian `watch` ke user**; itu bahasa orkestrator. Tulis ulang dengan kata-katamu sendiri bila perlu.
|
|
87
|
+
|
|
88
|
+
Bentuk laporan: (1) apakah yang diminta user sudah tercapai, (2) bukti yang menentukan dalam bahasa biasa, (3) keputusan yang benar-benar butuh user, bila ada. Jangan menarasikan pengiriman, penantian, atau balasan agent. Agent dilarang `git commit/push/reset/checkout/stash`; perubahan mereka ada di working tree dan commit tetap mengikuti izin user.
|
|
89
|
+
|
|
90
|
+
| Jangan | Tulis begini |
|
|
91
|
+
|---|---|
|
|
92
|
+
| "T3 dan T4 ditandai gagal (✗) karena pengecekan browser_tabs. Antrean dengan after ditolak, jadi saya kirim tanpa antrean, lalu saya ambil dengan terima." | "Kedua agent berhasil membuka halaman Devices dan datanya tampil lengkap (922 perangkat, 8 kolom, semua permintaan ke server berhasil). Hasil keduanya sama." |
|
|
93
|
+
| "T5 agy ✓ browser, scope ⚠ 1 di luar" | "agy selesai memeriksa halaman. Ada satu berkas yang berubah di luar tugasnya, yaitu README.md; kemungkinan hasil edit Anda sendiri." |
|
|
94
|
+
| "limit pada T7, dialihkan ke codex" | "agy kehabisan kuota, jadi pekerjaan itu saya pindahkan ke codex." |
|
|
95
|
+
| "T9 menunggu-izin" | "codex menunggu persetujuan Anda di sesinya (pilih izinkan). Pekerjaan lain tetap berjalan." |
|
|
71
96
|
|
|
72
|
-
|
|
97
|
+
Bila rempug menandai tugas gagal tetapi balasan agent menunjukkan pekerjaannya benar, itu kemungkinan alarm palsu: periksa dulu, lalu laporkan **hasil pekerjaannya**, bukan alarmnya.
|
|
73
98
|
|
|
74
99
|
## Integrasi
|
|
75
100
|
|