rempug 0.0.0-stage → 0.1.1

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,58 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { checkNodeVersion, MIN_NODE } from "../runtime.js";
3
+ export function defaultDoctorDeps() {
4
+ return {
5
+ nodeVersion: process.versions.node,
6
+ tmuxVersion: () => {
7
+ const result = spawnSync("tmux", ["-V"], { encoding: "utf8" });
8
+ return result.status === 0 ? result.stdout.trim() : undefined;
9
+ },
10
+ // Shell login mendekati lingkungan shell yang dipakai agent di pane tmux.
11
+ which: (command) => {
12
+ const result = spawnSync("sh", ["-lc", 'command -v "$1"', "sh", command], {
13
+ encoding: "utf8",
14
+ });
15
+ return result.status === 0 ? result.stdout.trim() : undefined;
16
+ },
17
+ };
18
+ }
19
+ export function runDoctor(deps = defaultDoctorDeps()) {
20
+ const node = checkNodeVersion(deps.nodeVersion);
21
+ const tmux = deps.tmuxVersion();
22
+ const rempug = deps.which("rempug");
23
+ const checks = [
24
+ node.ok
25
+ ? { nama: "node", ok: true, pesan: `Node ${deps.nodeVersion}` }
26
+ : {
27
+ nama: "node",
28
+ ok: false,
29
+ pesan: node.message,
30
+ perbaikan: `pasang Node ${MIN_NODE} atau lebih baru (mis. \`nvm install 22\`)`,
31
+ },
32
+ tmux
33
+ ? { nama: "tmux", ok: true, pesan: tmux }
34
+ : {
35
+ nama: "tmux",
36
+ ok: false,
37
+ pesan: "tmux tidak ditemukan",
38
+ perbaikan: "pasang tmux: `apt install tmux` (Linux) atau `brew install tmux` (macOS)",
39
+ },
40
+ rempug
41
+ ? { nama: "path", ok: true, pesan: rempug }
42
+ : {
43
+ nama: "path",
44
+ ok: false,
45
+ pesan: "perintah `rempug` tidak ada di PATH shell",
46
+ perbaikan: "jalankan `npm i -g rempug` agar agent dapat memanggil `rempug`",
47
+ },
48
+ ];
49
+ return { ok: checks.every((c) => c.ok), checks };
50
+ }
51
+ export function formatDoctor(result) {
52
+ const baris = result.checks.map((c) => c.ok
53
+ ? `✓ ${c.nama} ${c.pesan}`
54
+ : `✗ ${c.nama} ${c.pesan} — ${c.perbaikan}`);
55
+ const gagal = result.checks.filter((c) => !c.ok).length;
56
+ baris.push(gagal === 0 ? "semua lulus" : `${gagal} pemeriksaan tidak lulus`);
57
+ return baris.join("\n");
58
+ }
@@ -0,0 +1,16 @@
1
+ /** Galat yang pesannya aman ditampilkan apa adanya; `kode` menjadi kode keluar CLI. */
2
+ export class RempugError extends Error {
3
+ kode;
4
+ constructor(message, kode = 1) {
5
+ super(message);
6
+ this.kode = kode;
7
+ this.name = "RempugError";
8
+ }
9
+ }
10
+ /** Masukan pemakai salah (brief tidak lengkap, argumen keliru): kode keluar 2. */
11
+ export class UsageError extends RempugError {
12
+ constructor(message) {
13
+ super(message, 2);
14
+ this.name = "UsageError";
15
+ }
16
+ }
@@ -0,0 +1,35 @@
1
+ import { spawnSync } from "node:child_process";
2
+ function git(repo, args) {
3
+ const result = spawnSync("git", ["-C", repo, ...args], {
4
+ encoding: "utf8",
5
+ maxBuffer: 64 * 1024 * 1024,
6
+ });
7
+ return result.status === 0 ? result.stdout : undefined;
8
+ }
9
+ /** Akar repo git dari `cwd`; jatuh ke `cwd` bila bukan repo git. */
10
+ export function repoRoot(cwd) {
11
+ return git(cwd, ["rev-parse", "--show-toplevel"])?.trim() || cwd;
12
+ }
13
+ export function isGitRepo(dir) {
14
+ return git(dir, ["rev-parse", "--git-dir"]) !== undefined;
15
+ }
16
+ export function gitInfo(repo) {
17
+ return {
18
+ head: git(repo, ["rev-parse", "HEAD"])?.trim(),
19
+ branch: git(repo, ["rev-parse", "--abbrev-ref", "HEAD"])?.trim(),
20
+ porcelain: git(repo, ["status", "--porcelain", "-uall"])?.trimEnd(),
21
+ };
22
+ }
23
+ /** Daftar berkas terlacak maupun tidak terlacak (tanpa yang diabaikan) di bawah pathspec. */
24
+ export function gitFiles(repo, pathspecs) {
25
+ const out = git(repo, [
26
+ "ls-files",
27
+ "-z",
28
+ "--cached",
29
+ "--others",
30
+ "--exclude-standard",
31
+ "--",
32
+ ...pathspecs,
33
+ ]);
34
+ return out ? out.split("\0").filter(Boolean) : [];
35
+ }
@@ -0,0 +1,349 @@
1
+ import { mkdirSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { dirname, join } from "node:path";
4
+ import { DatabaseSync } from "node:sqlite";
5
+ export const DEFAULT_RETENTION_DAYS = 30;
6
+ /** Status tempat tugas masih ada di tangan agent: memegang klaim cakupan dan membuat agent berstatus sibuk. */
7
+ export const ACTIVE_STATUSES = [
8
+ "berjalan",
9
+ "menunggu-klarifikasi",
10
+ "memverifikasi",
11
+ ];
12
+ /** Kolom yang boleh diubah lewat `Ledger.patch`. */
13
+ const PATCH_COLUMNS = {
14
+ ackedAt: "acked_at",
15
+ verify: "verify",
16
+ paham: "paham",
17
+ jawaban: "jawaban",
18
+ putaran: "putaran",
19
+ scrHash: "scr_hash",
20
+ scrSince: "scr_since",
21
+ flag: "flag",
22
+ upaya: "upaya",
23
+ pengingat: "pengingat",
24
+ };
25
+ /** Lokasi ledger; mengikuti `XDG_STATE_HOME`, jatuh ke `~/.local/state`. */
26
+ export function ledgerPath(env = process.env) {
27
+ const state = env.XDG_STATE_HOME || join(env.HOME || homedir(), ".local", "state");
28
+ return join(state, "rempug", "ledger.db");
29
+ }
30
+ /** Masa simpan dalam hari; `REMPUG_RETENTION_DAYS` harus bilangan bulat positif. */
31
+ export function retentionDays(env = process.env) {
32
+ const raw = env.REMPUG_RETENTION_DAYS;
33
+ return raw && /^[1-9]\d*$/.test(raw) ? Number(raw) : DEFAULT_RETENTION_DAYS;
34
+ }
35
+ /** Tiap elemen adalah satu langkah migrasi; indeksnya + 1 adalah versi skema. */
36
+ export const MIGRASI = [
37
+ `
38
+ CREATE TABLE tasks (
39
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
40
+ repo TEXT NOT NULL,
41
+ agent TEXT NOT NULL,
42
+ mode TEXT NOT NULL CHECK (mode IN ('edit', 'baca', 'browser')),
43
+ scope TEXT,
44
+ status TEXT NOT NULL,
45
+ after_id INTEGER REFERENCES tasks(id) ON DELETE SET NULL,
46
+ brief TEXT NOT NULL,
47
+ head_sha TEXT,
48
+ branch TEXT,
49
+ sent_at INTEGER NOT NULL,
50
+ replied_at INTEGER,
51
+ reply_summary TEXT,
52
+ reply_detail TEXT
53
+ );
54
+ CREATE INDEX tasks_repo_status ON tasks (repo, status);
55
+ CREATE TABLE snapshots (
56
+ task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
57
+ path TEXT NOT NULL,
58
+ hash TEXT NOT NULL,
59
+ content BLOB,
60
+ PRIMARY KEY (task_id, path)
61
+ );
62
+ CREATE TABLE events (
63
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
64
+ ts INTEGER NOT NULL,
65
+ task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
66
+ kind TEXT NOT NULL,
67
+ line TEXT NOT NULL
68
+ );
69
+ `,
70
+ `
71
+ ALTER TABLE tasks ADD COLUMN acked_at INTEGER;
72
+ ALTER TABLE tasks ADD COLUMN verify TEXT;
73
+ ALTER TABLE tasks ADD COLUMN teliti INTEGER NOT NULL DEFAULT 0;
74
+ ALTER TABLE tasks ADD COLUMN centang TEXT;
75
+ ALTER TABLE tasks ADD COLUMN paham TEXT;
76
+ ALTER TABLE tasks ADD COLUMN jawaban TEXT;
77
+ ALTER TABLE tasks ADD COLUMN putaran INTEGER NOT NULL DEFAULT 0;
78
+ ALTER TABLE tasks ADD COLUMN porcelain TEXT;
79
+ ALTER TABLE tasks ADD COLUMN scr_hash TEXT;
80
+ ALTER TABLE tasks ADD COLUMN scr_since INTEGER;
81
+ ALTER TABLE tasks ADD COLUMN flag TEXT;
82
+ ALTER TABLE tasks ADD COLUMN upaya INTEGER NOT NULL DEFAULT 0;
83
+ ALTER TABLE tasks ADD COLUMN pengingat INTEGER NOT NULL DEFAULT 0;
84
+ CREATE TABLE consumers (
85
+ name TEXT PRIMARY KEY,
86
+ last_event_id INTEGER NOT NULL DEFAULT 0,
87
+ last_seen INTEGER
88
+ );
89
+ `,
90
+ ];
91
+ function tidurSinkron(ms) {
92
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
93
+ }
94
+ /**
95
+ * SQLite dapat mengembalikan SQLITE_BUSY seketika, tanpa menunggu `busy_timeout`, bila menunggu berisiko
96
+ * deadlock (mis. dua proses beralih ke WAL pada berkas baru bersamaan). Satu-satunya jalan adalah mengulang.
97
+ * Galat selain BUSY/LOCKED tidak diulang.
98
+ */
99
+ export function ulangiBilaTerkunci(fn, batasMs = 10_000) {
100
+ const akhir = Date.now() + batasMs;
101
+ for (let i = 0;; i++) {
102
+ try {
103
+ return fn();
104
+ }
105
+ catch (error) {
106
+ const kode = error.errcode;
107
+ const terkunci = kode === 5 ||
108
+ kode === 6 ||
109
+ /locked|busy/i.test(error.message);
110
+ if (!terkunci || Date.now() >= akhir)
111
+ throw error;
112
+ tidurSinkron(Math.min(5 * 2 ** Math.min(i, 5), 100));
113
+ }
114
+ }
115
+ }
116
+ function migrate(db) {
117
+ // IMMEDIATE: dua proses yang membuka ledger baru bersamaan harus antre, bukan sama-sama membuat tabel.
118
+ db.exec("BEGIN IMMEDIATE");
119
+ try {
120
+ const row = db.prepare("PRAGMA user_version").get();
121
+ if (row.user_version > MIGRASI.length)
122
+ throw new Error(`ledger ini dibuat oleh rempug versi lebih baru (skema ${row.user_version}, dikenal ${MIGRASI.length}); perbarui rempug.`);
123
+ for (let v = row.user_version; v < MIGRASI.length; v++)
124
+ db.exec(MIGRASI[v]);
125
+ db.exec(`PRAGMA user_version = ${MIGRASI.length}`);
126
+ db.exec("COMMIT");
127
+ }
128
+ catch (error) {
129
+ db.exec("ROLLBACK");
130
+ throw error;
131
+ }
132
+ }
133
+ function toTask(row) {
134
+ return {
135
+ id: row.id,
136
+ repo: row.repo,
137
+ agent: row.agent,
138
+ mode: row.mode,
139
+ scope: row.scope
140
+ ? JSON.parse(row.scope)
141
+ : undefined,
142
+ status: row.status,
143
+ afterId: row.after_id ?? undefined,
144
+ brief: row.brief,
145
+ headSha: row.head_sha ?? undefined,
146
+ branch: row.branch ?? undefined,
147
+ sentAt: row.sent_at,
148
+ repliedAt: row.replied_at ?? undefined,
149
+ replySummary: row.reply_summary ?? undefined,
150
+ replyDetail: row.reply_detail ?? undefined,
151
+ ackedAt: row.acked_at ?? undefined,
152
+ verify: row.verify ?? undefined,
153
+ teliti: row.teliti === 1,
154
+ centang: row.centang ?? undefined,
155
+ paham: row.paham ?? undefined,
156
+ jawaban: row.jawaban ?? undefined,
157
+ putaran: row.putaran,
158
+ porcelain: row.porcelain ?? undefined,
159
+ scrHash: row.scr_hash ?? undefined,
160
+ scrSince: row.scr_since ?? undefined,
161
+ flag: row.flag ?? undefined,
162
+ upaya: row.upaya,
163
+ pengingat: row.pengingat,
164
+ };
165
+ }
166
+ /** Ledger tugas dan event di satu berkas SQLite di luar repo proyek. */
167
+ export class Ledger {
168
+ static SCHEMA_VERSION = MIGRASI.length;
169
+ #db;
170
+ #now;
171
+ constructor(db, now) {
172
+ this.#db = db;
173
+ this.#now = now;
174
+ }
175
+ static open(path = ledgerPath(), options = {}) {
176
+ mkdirSync(dirname(path), { recursive: true });
177
+ const db = new DatabaseSync(path);
178
+ db.exec("PRAGMA busy_timeout = 5000");
179
+ ulangiBilaTerkunci(() => db.exec("PRAGMA journal_mode = WAL"));
180
+ db.exec("PRAGMA synchronous = NORMAL");
181
+ db.exec("PRAGMA foreign_keys = ON");
182
+ ulangiBilaTerkunci(() => migrate(db));
183
+ return new Ledger(db, options.now ?? (() => Math.floor(Date.now() / 1000)));
184
+ }
185
+ close() {
186
+ this.#db.close();
187
+ }
188
+ createTask(input) {
189
+ const result = this.#db
190
+ .prepare(`INSERT INTO tasks (repo, agent, mode, scope, status, after_id, brief, head_sha, branch, sent_at, teliti, centang, porcelain)
191
+ VALUES (?, ?, ?, ?, 'antri', ?, ?, ?, ?, ?, ?, ?, ?)`)
192
+ .run(input.repo, input.agent, input.mode, input.scope ? JSON.stringify(input.scope) : null, input.afterId ?? null, input.brief, input.headSha ?? null, input.branch ?? null, this.#now(), input.teliti ? 1 : 0, input.centang ?? null, input.porcelain ?? null);
193
+ return Number(result.lastInsertRowid);
194
+ }
195
+ getTask(id) {
196
+ const row = this.#db.prepare("SELECT * FROM tasks WHERE id = ?").get(id);
197
+ return row ? toTask(row) : undefined;
198
+ }
199
+ listTasks(repo) {
200
+ return this.#db
201
+ .prepare("SELECT * FROM tasks WHERE repo = ? ORDER BY id")
202
+ .all(repo)
203
+ .map(toTask);
204
+ }
205
+ /** Tugas `edit` yang masih memegang klaim cakupan di repo ini. */
206
+ activeEditTasks(repo) {
207
+ const marks = ACTIVE_STATUSES.map(() => "?").join(", ");
208
+ return this.#db
209
+ .prepare(`SELECT * FROM tasks WHERE repo = ? AND mode = 'edit' AND status IN (${marks}) ORDER BY id`)
210
+ .all(repo, ...ACTIVE_STATUSES)
211
+ .map(toTask);
212
+ }
213
+ /** Tugas aktif terbaru milik agent ini di repo mana pun, bila ada. */
214
+ activeTaskOf(agent) {
215
+ const marks = ACTIVE_STATUSES.map(() => "?").join(", ");
216
+ const row = this.#db
217
+ .prepare(`SELECT * FROM tasks WHERE agent = ? AND status IN (${marks}) ORDER BY id DESC LIMIT 1`)
218
+ .get(agent, ...ACTIVE_STATUSES);
219
+ return row ? toTask(row) : undefined;
220
+ }
221
+ /** Menghapus tugas beserta snapshot dan event-nya (mis. tugas uji probe). */
222
+ deleteTask(id) {
223
+ this.#db.prepare("DELETE FROM tasks WHERE id = ?").run(id);
224
+ }
225
+ /** Tugas repo ini dengan status tertentu, berurutan menurut ID. */
226
+ tasksWhere(repo, statuses) {
227
+ const marks = statuses.map(() => "?").join(", ");
228
+ return this.#db
229
+ .prepare(`SELECT * FROM tasks WHERE repo = ? AND status IN (${marks}) ORDER BY id`)
230
+ .all(repo, ...statuses)
231
+ .map(toTask);
232
+ }
233
+ /** Mengubah kolom tertentu; galat bila tugas tidak ada. */
234
+ patch(id, fields) {
235
+ const entries = Object.entries(fields);
236
+ if (entries.length === 0)
237
+ return;
238
+ const sets = entries.map(([k]) => `${PATCH_COLUMNS[k]} = ?`).join(", ");
239
+ const result = this.#db
240
+ .prepare(`UPDATE tasks SET ${sets} WHERE id = ?`)
241
+ .run(...entries.map(([, v]) => v ?? null), id);
242
+ if (result.changes === 0)
243
+ throw new Error(`tugas T${id} tidak ada`);
244
+ }
245
+ /** Menandai brief sudah dibaca agent; `true` hanya pada pembacaan pertama. */
246
+ markAcked(id) {
247
+ const result = this.#db
248
+ .prepare("UPDATE tasks SET acked_at = ? WHERE id = ? AND acked_at IS NULL")
249
+ .run(this.#now(), id);
250
+ return result.changes > 0;
251
+ }
252
+ addSnapshot(taskId, path, hash, content) {
253
+ this.#db
254
+ .prepare("INSERT OR REPLACE INTO snapshots (task_id, path, hash, content) VALUES (?, ?, ?, ?)")
255
+ .run(taskId, path, hash, content);
256
+ }
257
+ getSnapshots(taskId) {
258
+ return this.#db
259
+ .prepare("SELECT path, hash, content FROM snapshots WHERE task_id = ? ORDER BY path")
260
+ .all(taskId)
261
+ .map((row) => ({
262
+ path: row.path,
263
+ hash: row.hash,
264
+ content: row.content ?? null,
265
+ }));
266
+ }
267
+ /** Membuat konsumen kejadian bila belum ada; kursor awal tidak menimpa yang sudah ada. */
268
+ ensureConsumer(name, cursor) {
269
+ this.#db
270
+ .prepare("INSERT OR IGNORE INTO consumers (name, last_event_id) VALUES (?, ?)")
271
+ .run(name, cursor);
272
+ }
273
+ getConsumer(name) {
274
+ const row = this.#db
275
+ .prepare("SELECT * FROM consumers WHERE name = ?")
276
+ .get(name);
277
+ return row
278
+ ? {
279
+ name: row.name,
280
+ lastEventId: row.last_event_id,
281
+ lastSeen: row.last_seen ?? undefined,
282
+ }
283
+ : undefined;
284
+ }
285
+ /** Memajukan kursor (tidak pernah mundur) dan mencatat waktu terakhir terlihat. */
286
+ advanceConsumer(name, eventId) {
287
+ this.#db
288
+ .prepare("UPDATE consumers SET last_event_id = MAX(last_event_id, ?), last_seen = ? WHERE name = ?")
289
+ .run(eventId, this.#now(), name);
290
+ }
291
+ /** Mencatat bahwa konsumen masih hidup tanpa menggeser kursor. */
292
+ touchConsumer(name) {
293
+ this.#db
294
+ .prepare("UPDATE consumers SET last_seen = ? WHERE name = ?")
295
+ .run(this.#now(), name);
296
+ }
297
+ /** ID event terbesar di repo ini; 0 bila belum ada. */
298
+ maxEventId(repo) {
299
+ const row = this.#db
300
+ .prepare(`SELECT COALESCE(MAX(e.id), 0) AS id FROM events e JOIN tasks t ON t.id = e.task_id WHERE t.repo = ?`)
301
+ .get(repo);
302
+ return row.id;
303
+ }
304
+ /** Waktu sekarang menurut jam ledger (detik); dipakai bersama agar uji dapat mengatur jam. */
305
+ now() {
306
+ return this.#now();
307
+ }
308
+ setStatus(id, status) {
309
+ const result = this.#db
310
+ .prepare("UPDATE tasks SET status = ? WHERE id = ?")
311
+ .run(status, id);
312
+ if (result.changes === 0)
313
+ throw new Error(`tugas T${id} tidak ada`);
314
+ }
315
+ saveReply(id, summary, detail) {
316
+ const result = this.#db
317
+ .prepare("UPDATE tasks SET reply_summary = ?, reply_detail = ?, replied_at = ? WHERE id = ?")
318
+ .run(summary, detail, this.#now(), id);
319
+ if (result.changes === 0)
320
+ throw new Error(`tugas T${id} tidak ada`);
321
+ }
322
+ addEvent(taskId, kind, line) {
323
+ const result = this.#db
324
+ .prepare("INSERT INTO events (ts, task_id, kind, line) VALUES (?, ?, ?, ?)")
325
+ .run(this.#now(), taskId, kind, line);
326
+ return Number(result.lastInsertRowid);
327
+ }
328
+ /** Event repo ini dengan id lebih besar dari `afterId`, berurutan. */
329
+ eventsAfter(afterId, repo) {
330
+ return this.#db
331
+ .prepare(`SELECT e.id, e.ts, e.task_id, e.kind, e.line
332
+ FROM events e JOIN tasks t ON t.id = e.task_id
333
+ WHERE e.id > ? AND t.repo = ? ORDER BY e.id`)
334
+ .all(afterId, repo)
335
+ .map((row) => ({
336
+ id: row.id,
337
+ ts: row.ts,
338
+ taskId: row.task_id,
339
+ kind: row.kind,
340
+ line: row.line,
341
+ }));
342
+ }
343
+ /** Menghapus tugas lebih tua dari `days` hari (snapshot dan event ikut terhapus); mengembalikan jumlahnya. */
344
+ purgeOlderThan(days) {
345
+ return Number(this.#db
346
+ .prepare("DELETE FROM tasks WHERE sent_at < ?")
347
+ .run(this.#now() - days * 86_400).changes);
348
+ }
349
+ }
@@ -0,0 +1,149 @@
1
+ import { parseBrief } from "./brief.js";
2
+ import { RempugError, UsageError } from "./errors.js";
3
+ import { PROFIL_BAWAAN } from "./profile.js";
4
+ import { readAgents } from "./registry.js";
5
+ import { covers } from "./scope.js";
6
+ import { parseSections } from "./sections.js";
7
+ const LABELS = ["CAKUPAN", "CEK", "RENCANA", "ASUMSI", "PERTANYAAN"];
8
+ const MAKS_PUTARAN = 3;
9
+ const MAKS_BUTIR = 3;
10
+ /** Tindakan yang tidak boleh muncul di rencana agent. */
11
+ const TERLARANG = /\bgit\s+(commit|push|reset|checkout|stash|rebase|clean|merge|cherry-pick)\b|\brm\s+-[a-z]*r[a-z]*\b|\bsudo\b|--force\b|--no-verify\b/i;
12
+ const kosong = (teks) => !teks || /^(-|\(kosong\)|tidak ada)$/i.test(teks.trim());
13
+ const normalisasi = (path) => path.replace(/^(\.\/)+/, "").replace(/\/+$/, "");
14
+ function sama(a, b) {
15
+ const x = [...new Set(a)].sort();
16
+ const y = [...new Set(b)].sort();
17
+ return x.length === y.length && x.every((v, i) => v === y[i]);
18
+ }
19
+ const baris = (teks) => teks
20
+ .split("\n")
21
+ .map((l) => l.trim())
22
+ .filter(Boolean);
23
+ /** Path yang disebut di teks: token yang memuat `/` atau berakhiran ekstensi, bukan URL atau opsi. */
24
+ function pathDisebut(teks) {
25
+ return teks
26
+ .split(/[\s`'"(),;:]+/)
27
+ .map((t) => t.replace(/\.+$/, ""))
28
+ .filter((t) => t !== "" &&
29
+ !t.startsWith("-") &&
30
+ !t.includes("://") &&
31
+ (t.includes("/") || /\.[a-z][a-z0-9]{1,4}$/i.test(t)));
32
+ }
33
+ const potong = (teks, panjang) => teks.length > panjang ? `${teks.slice(0, panjang - 1)}…` : teks;
34
+ /** Alasan konfirmasi pemahaman tidak boleh disetujui otomatis; kosong berarti cocok. */
35
+ function bandingkan(task, bagian) {
36
+ const parsed = parseBrief(task.brief);
37
+ if (!parsed.ok || parsed.brief.cakupan.mode !== "edit")
38
+ throw new RempugError(`brief T${task.id} tersimpan tidak valid`);
39
+ const scope = parsed.brief.cakupan.paths;
40
+ const alasan = [];
41
+ const cakupan = (bagian.get("CAKUPAN") ?? "").split(/[\s,]+/).filter(Boolean);
42
+ if (cakupan[0] === "edit")
43
+ cakupan.shift();
44
+ if (!sama(cakupan.map(normalisasi), scope.map(normalisasi)))
45
+ 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");
49
+ const rencanaTeks = bagian.get("RENCANA") ?? "";
50
+ const rencana = baris(rencanaTeks).map((l) => l.replace(/^(\d+[.)]|[-*•])\s+/, ""));
51
+ if (rencana.length > MAKS_BUTIR)
52
+ alasan.push(`rencana lebih dari ${MAKS_BUTIR} butir (${rencana.length})`);
53
+ const luar = pathDisebut(rencanaTeks).filter((p) => !covers(scope, p));
54
+ if (luar.length > 0)
55
+ alasan.push(`rencana menyentuh di luar cakupan: ${luar.join(", ")}`);
56
+ const terlarang = TERLARANG.exec(`${rencanaTeks}\n${bagian.get("ASUMSI") ?? ""}`);
57
+ if (terlarang)
58
+ alasan.push(`rencana memuat tindakan terlarang: ${terlarang[0]}`);
59
+ if (!kosong(bagian.get("ASUMSI")))
60
+ alasan.push(`asumsi: ${bagian.get("ASUMSI")}`);
61
+ if (!kosong(bagian.get("PERTANYAAN")))
62
+ alasan.push(`pertanyaan: ${bagian.get("PERTANYAAN")}`);
63
+ return { alasan, rencana };
64
+ }
65
+ /**
66
+ * Konfirmasi pemahaman dari agent. Disetujui otomatis (tanpa token orkestrator) bila isinya
67
+ * cocok dengan brief; selain itu tugas ditahan dan satu kejadian dikeluarkan.
68
+ */
69
+ export function paham(ledger, id, teks) {
70
+ const task = ledger.getTask(id);
71
+ if (!task)
72
+ throw new RempugError(`tugas T${id} tidak ada`);
73
+ if (task.status !== "berjalan" && task.status !== "menunggu-klarifikasi")
74
+ throw new RempugError(`tugas T${id} berstatus ${task.status}; paham tidak berlaku`);
75
+ if (task.mode !== "edit") {
76
+ ledger.patch(id, { paham: teks });
77
+ return { hasil: "LANJUT" };
78
+ }
79
+ const { body, errors } = parseSections(teks, LABELS);
80
+ for (const label of LABELS)
81
+ if (!body.has(label))
82
+ errors.push(`bagian ${label} hilang`);
83
+ if (errors.length > 0)
84
+ throw new UsageError(`format paham salah:\n${errors.map((e) => `- ${e}`).join("\n")}`);
85
+ const { alasan, rencana } = bandingkan(task, body);
86
+ if (task.teliti)
87
+ alasan.push(`--teliti, rencana: ${rencana.join(" / ")}`);
88
+ if (alasan.length === 0) {
89
+ ledger.patch(id, { paham: teks });
90
+ return { hasil: "LANJUT" };
91
+ }
92
+ const putaran = task.putaran + 1;
93
+ if (putaran > MAKS_PUTARAN) {
94
+ ledger.setStatus(id, "gagal-paham");
95
+ ledger.addEvent(id, "gagal-paham", `T${id} ${task.agent} ✗ gagal-paham setelah ${MAKS_PUTARAN} putaran klarifikasi`);
96
+ return { hasil: "GAGAL-PAHAM" };
97
+ }
98
+ ledger.patch(id, { paham: teks, putaran });
99
+ ledger.setStatus(id, "menunggu-klarifikasi");
100
+ const ringkas = alasan.join("; ").replace(/\s*\n\s*/g, " ");
101
+ ledger.addEvent(id, "klarifikasi", potong(`T${id} ${task.agent} menunggu-klarifikasi: ${ringkas}`, 300));
102
+ return { hasil: "MENUNGGU", alasan: ringkas };
103
+ }
104
+ /**
105
+ * Jawaban orkestrator. Bila tugas menunggu klarifikasi, jawaban disimpan untuk diambil agent
106
+ * lewat `tunggu`; bila agent bertanya di obrolan (tugas berjalan), teksnya disuntikkan ke agent.
107
+ */
108
+ export async function jawab(deps, id, teks) {
109
+ const task = deps.ledger.getTask(id);
110
+ if (!task)
111
+ throw new RempugError(`tugas T${id} tidak ada`);
112
+ if (task.status === "menunggu-klarifikasi") {
113
+ deps.ledger.patch(id, { jawaban: teks });
114
+ return "disimpan";
115
+ }
116
+ if (task.status === "berjalan") {
117
+ const agent = readAgents(deps.registryFile).find((a) => a.name === task.agent);
118
+ if (!agent)
119
+ throw new RempugError(`agent "${task.agent}" tidak terdaftar`);
120
+ await deps.transport.kirim(agent.tmux, teks, agent.kirim ?? PROFIL_BAWAAN);
121
+ return "dikirim";
122
+ }
123
+ throw new RempugError(`tugas T${id} berstatus ${task.status}; tidak ada yang dijawab`);
124
+ }
125
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
126
+ /** Agent menunggu jawaban; menahan paling lama `timeoutMs` dan aman diulang. */
127
+ export async function tunggu(ledger, id, options = {}) {
128
+ const { timeoutMs = 45_000, pollMs = 500 } = options;
129
+ const akhir = Date.now() + timeoutMs;
130
+ for (;;) {
131
+ const task = ledger.getTask(id);
132
+ if (!task)
133
+ throw new RempugError(`tugas T${id} tidak ada`);
134
+ if (task.status === "berjalan")
135
+ return "LANJUT";
136
+ if (task.status === "gagal-paham")
137
+ return `GAGAL-PAHAM: batas klarifikasi terlampaui; berhenti dan jalankan \`rempug reply T${id} --gagal\`.`;
138
+ if (task.status !== "menunggu-klarifikasi")
139
+ return `STOP: tugas berstatus ${task.status}.`;
140
+ if (task.jawaban) {
141
+ ledger.setStatus(id, "berjalan");
142
+ ledger.patch(id, { jawaban: null });
143
+ return `JAWABAN: ${task.jawaban}\nLANJUT`;
144
+ }
145
+ if (Date.now() >= akhir)
146
+ return `BELUM: belum ada jawaban; jalankan \`rempug tunggu T${id}\` lagi.`;
147
+ await sleep(pollMs);
148
+ }
149
+ }