rempug 0.1.2 → 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
@@ -169,6 +169,8 @@ Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalanka
169
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
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
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.
172
174
  - Windows tidak didukung (tmux).
173
175
 
174
176
  ## Pengembangan
@@ -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.2",
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