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 +2 -0
- 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
|
@@ -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
|
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
|