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.
@@ -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
- 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,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, 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
- # 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
- # Atau manual
101
+ # B. Manual
33
102
  rempug skill install
34
103
  claude mcp add --scope user rempug -- rempug mcp
35
104
  ```
36
105
 
37
- Agent yang Anda delegasikan harus bisa menjalankan `rempug` dari shell-nya (`rempug doctor` memeriksanya).
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,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, 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`.
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/); versi, `CHANGELOG.md`, GitHub Release, dan publish npm dihasilkan otomatis oleh semantic-release dari cabang `main`.
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
 
@@ -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, { md: { type: "string" } });
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(formatLaporan(h.repo, tasks));
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, {
@@ -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
+ }
@@ -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 [
@@ -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
- const cek = parsed.ok ? parsed.brief.cek : [];
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 ringkas: selesai, berjalan, gagal, blocker. md menulis berkas Markdown.", { md: z.string().optional() }, (a) => ({
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rempug",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Distribusi kerja dari agent orkestrator ke agent CLI lain lewat tmux, hemat token.",
5
5
  "keywords": [
6
6
  "agent",
@@ -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
- ### Laporan ke user
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
- Hanya hasil: apakah tujuan user tercapai, bukti yang menentukan (mis. "tsc, biome, vitest lulus; 3 file berubah"), dan keputusan yang butuh user. 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.
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