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,204 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { createHash } from "node:crypto";
3
+ import { RempugError } from "./errors.js";
4
+ import { KANDIDAT } from "./profile.js";
5
+ import { readAgents, updateAgent } from "./registry.js";
6
+ import { hashLayar, klasifikasi, tokenDiLayar } from "./screen.js";
7
+ import { pointer } from "./send.js";
8
+ import { listPanes } from "./tmux.js";
9
+ const BRIEF_PING = "TUJUAN: probe pengiriman\nCAKUPAN: baca\nLANGKAH:\n1. Tidak perlu melakukan apa pun selain membaca tugas ini.\nCEK: -\nBALASAN: -";
10
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
11
+ const sha1 = (teks) => createHash("sha1").update(teks).digest("hex");
12
+ /** Versi CLI agent (baris pertama `--version`), atau kosong bila tidak bisa dibaca. */
13
+ export function versiAgent(jenis) {
14
+ const hasil = spawnSync(jenis, ["--version"], {
15
+ encoding: "utf8",
16
+ timeout: 3000,
17
+ });
18
+ if (hasil.error || hasil.status !== 0)
19
+ return undefined;
20
+ return hasil.stdout
21
+ .split("\n")
22
+ .find((l) => l.trim() !== "")
23
+ ?.trim();
24
+ }
25
+ /**
26
+ * Menunggu agent membaca brief. Model sungguhan bisa butuh puluhan detik, jadi selama layarnya masih
27
+ * berubah (agent bekerja) probe terus menunggu sampai batas atas; ia hanya menyerah bila lewat batas dasar
28
+ * dan layar sudah tenang. Spinner dan timer tidak dihitung sebagai perubahan.
29
+ */
30
+ async function tungguAck(ledger, transport, target, id, batas) {
31
+ const mulai = Date.now();
32
+ const ambil = (lama) => {
33
+ try {
34
+ return hashLayar(transport.layar(target, 40));
35
+ }
36
+ catch {
37
+ return lama;
38
+ }
39
+ };
40
+ let hash = ambil("");
41
+ let berubahPada = mulai;
42
+ for (;;) {
43
+ if (ledger.getTask(id)?.ackedAt !== undefined)
44
+ return true;
45
+ const kini = Date.now();
46
+ if (kini - mulai >= batas.maksMs)
47
+ return false;
48
+ const baru = ambil(hash);
49
+ if (baru !== hash) {
50
+ hash = baru;
51
+ berubahPada = kini;
52
+ }
53
+ if (kini - mulai >= batas.dasarMs && kini - berubahPada >= batas.tenangMs)
54
+ return false;
55
+ await sleep(120);
56
+ }
57
+ }
58
+ const cuplik = (baris) => baris
59
+ .map((b) => b.trimEnd())
60
+ .filter(Boolean)
61
+ .slice(-30)
62
+ .join("\n");
63
+ /**
64
+ * Mengukur cara berkomunikasi dengan satu agent: teknik kirim yang benar-benar sampai (diuji lewat
65
+ * tugas `ping` yang harus dibaca agent), waktu ack, dan apakah layarnya beranimasi saat idle.
66
+ * Hasilnya disimpan di registry. Tidak pernah menjawab prompt izin atas nama user.
67
+ */
68
+ export async function probeAgent(deps, nama) {
69
+ const { ledger, transport } = deps;
70
+ const agent = readAgents(deps.registryFile).find((a) => a.name === nama);
71
+ if (!agent)
72
+ throw new RempugError(`agent "${nama}" tidak terdaftar`);
73
+ if (!listPanes(deps.tmux).some((p) => p.target === agent.tmux))
74
+ throw new RempugError(`pane ${agent.tmux} milik agent "${nama}" tidak ada di tmux`);
75
+ const kandidat = deps.kandidat ?? KANDIDAT;
76
+ const batas = {
77
+ dasarMs: deps.ackTimeoutMs ?? 20_000,
78
+ tenangMs: deps.tenangMs ?? 4000,
79
+ maksMs: deps.ackMaksMs ?? 90_000,
80
+ };
81
+ const baseline = deps.baselineMs ?? 1500;
82
+ const hash = new Set();
83
+ for (let i = 0; i < 4; i++) {
84
+ hash.add(sha1(transport.tampak(agent.tmux).baris.join("\n")));
85
+ await sleep(baseline / 4);
86
+ }
87
+ const animasiIdle = hash.size > 1;
88
+ const versi = (deps.versi ?? versiAgent)(agent.kind) ?? agent.versi;
89
+ let dicoba = 0;
90
+ let alasan;
91
+ let hasil;
92
+ let layarAkhir = [];
93
+ for (const profil of kandidat) {
94
+ dicoba++;
95
+ const id = ledger.createTask({
96
+ repo: deps.repo,
97
+ agent: nama,
98
+ mode: "baca",
99
+ brief: BRIEF_PING,
100
+ });
101
+ ledger.setStatus(id, "berjalan");
102
+ const mulai = Date.now();
103
+ try {
104
+ await transport.kirim(agent.tmux, pointer(id), profil);
105
+ if (await tungguAck(ledger, transport, agent.tmux, id, batas)) {
106
+ const ackMs = Date.now() - mulai;
107
+ await sleep(Math.min(1500, baseline));
108
+ const baris = transport
109
+ .tampak(agent.tmux)
110
+ .baris.filter((b) => b.trim() !== "");
111
+ const penandaSiap = /^\s*([^\p{L}\p{N}\s]{1,4})/u.exec(baris.at(-1) ?? "")?.[1];
112
+ hasil = { nama, status: "siap", profil, ackMs, dicoba };
113
+ updateAgent(deps.registryFile, nama, {
114
+ kirim: profil,
115
+ tidakAndal: false,
116
+ versi,
117
+ gagalBeruntun: 0,
118
+ catatan: undefined,
119
+ ukur: { ackMs, animasiIdle, penandaSiap, probeAt: ledger.now() },
120
+ });
121
+ return hasil;
122
+ }
123
+ const { baris, kursorY } = transport.tampak(agent.tmux);
124
+ layarAkhir = baris;
125
+ const token = `rempug brief T${id}`;
126
+ const keadaan = klasifikasi({ baris, kursorY, berubah: false, token });
127
+ if (keadaan === "menunggu-izin") {
128
+ hasil = {
129
+ nama,
130
+ status: "perlu-izin",
131
+ dicoba,
132
+ catatan: `agent menunggu izin menjalankan rempug: setujui sekali di sesi ${agent.tmux} (pilih izinkan selalu), lalu ulangi /rempug`,
133
+ };
134
+ break;
135
+ }
136
+ if (keadaan === "error") {
137
+ hasil = {
138
+ nama,
139
+ status: "tidak-andal",
140
+ dicoba,
141
+ catatan: "agent melaporkan galat (limit, kuota, atau autentikasi); periksa `layar <agent>`, lalu login atau coba lagi nanti",
142
+ };
143
+ break;
144
+ }
145
+ if (keadaan === "tertahan")
146
+ alasan = "tertahan";
147
+ else if (tokenDiLayar(baris, token)) {
148
+ // Teks ada di riwayat percakapan: agent menerimanya, jadi tidak boleh dikirim ulang.
149
+ hasil = {
150
+ nama,
151
+ status: "tanpa-ack",
152
+ dicoba,
153
+ catatan: "pointer diterima tetapi agent tidak menjalankan rempug (kemungkinan: `rempug` tidak ada di PATH shell agent, agent menunggu izin, atau tidak mengikuti protokol; lihat `layar <agent>`)",
154
+ };
155
+ break;
156
+ }
157
+ else
158
+ alasan = "dibuang";
159
+ await transport.tekan(agent.tmux, ["C-u"]);
160
+ }
161
+ finally {
162
+ ledger.deleteTask(id);
163
+ }
164
+ }
165
+ hasil ??= {
166
+ nama,
167
+ status: "tidak-andal",
168
+ dicoba,
169
+ catatan: alasan === "tertahan"
170
+ ? `teks tertahan di kotak input; ${dicoba} kombinasi dicoba`
171
+ : `teks tidak pernah muncul di layar; ${dicoba} kombinasi dicoba`,
172
+ };
173
+ hasil.cuplikan = cuplik(layarAkhir);
174
+ if (hasil.status !== "perlu-izin")
175
+ updateAgent(deps.registryFile, nama, {
176
+ tidakAndal: true,
177
+ catatan: hasil.catatan,
178
+ versi,
179
+ ukur: { ...agent.ukur, animasiIdle, probeAt: ledger.now() },
180
+ });
181
+ return hasil;
182
+ }
183
+ /** Profil usang bila versi CLI agent berubah atau pengiriman gagal berturut-turut dua kali. */
184
+ export function isStale(agent, versiSekarang) {
185
+ if ((agent.gagalBeruntun ?? 0) >= 2)
186
+ return true;
187
+ return (agent.versi !== undefined &&
188
+ versiSekarang !== undefined &&
189
+ agent.versi !== versiSekarang);
190
+ }
191
+ /** Memprobe ulang agent hanya bila profilnya usang; mengembalikan `undefined` bila tidak perlu. */
192
+ export async function reprobeJikaUsang(deps, nama, versiSekarang) {
193
+ const agent = readAgents(deps.registryFile).find((a) => a.name === nama);
194
+ if (!agent || !isStale(agent, versiSekarang))
195
+ return undefined;
196
+ return probeAgent(deps, nama);
197
+ }
198
+ /** Satu baris kesiapan agent untuk laporan `/rempug`. */
199
+ export function formatProbe(hasil) {
200
+ const nama = hasil.nama.padEnd(10);
201
+ if (hasil.status === "siap")
202
+ return `${nama}✓ siap ack ${((hasil.ackMs ?? 0) / 1000).toFixed(1)} dtk`;
203
+ return `${nama}✗ ${hasil.status} ${hasil.catatan ?? ""}`.trimEnd();
204
+ }
@@ -0,0 +1,31 @@
1
+ export const PROFIL_BAWAAN = {
2
+ suntik: "keys",
3
+ sebelum: [],
4
+ submit: ["Enter"],
5
+ jeda_ms: 400,
6
+ };
7
+ /** Kombinasi yang dicoba berurutan saat probe; urutan dari yang paling umum. */
8
+ export const KANDIDAT = [
9
+ PROFIL_BAWAAN,
10
+ { suntik: "paste", sebelum: [], submit: ["Enter"], jeda_ms: 400 },
11
+ { suntik: "keys", sebelum: ["C-u"], submit: ["Enter"], jeda_ms: 400 },
12
+ {
13
+ suntik: "keys",
14
+ sebelum: ["C-u"],
15
+ submit: ["Enter", "Enter"],
16
+ jeda_ms: 600,
17
+ },
18
+ { suntik: "paste", sebelum: ["C-u"], submit: ["Enter"], jeda_ms: 600 },
19
+ {
20
+ suntik: "paste",
21
+ sebelum: ["Escape", "C-u"],
22
+ submit: ["Enter"],
23
+ jeda_ms: 1000,
24
+ },
25
+ {
26
+ suntik: "keys",
27
+ sebelum: ["Escape", "C-u"],
28
+ submit: ["Enter", "Enter"],
29
+ jeda_ms: 1000,
30
+ },
31
+ ];
@@ -0,0 +1,78 @@
1
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { dirname, join } from "node:path";
4
+ const NAME = /^[a-z][a-z0-9-]{0,29}$/;
5
+ /** Lokasi registry; mengikuti `XDG_CONFIG_HOME`, jatuh ke `~/.config`. */
6
+ export function registryPath(env = process.env) {
7
+ const config = env.XDG_CONFIG_HOME || join(env.HOME || homedir(), ".config");
8
+ return join(config, "rempug", "registry.json");
9
+ }
10
+ function isAgent(value) {
11
+ if (typeof value !== "object" || value === null)
12
+ return false;
13
+ const a = value;
14
+ return (typeof a.name === "string" &&
15
+ typeof a.kind === "string" &&
16
+ typeof a.tmux === "string" &&
17
+ Array.isArray(a.capabilities) &&
18
+ a.capabilities.every((c) => typeof c === "string"));
19
+ }
20
+ /** Agent terdaftar; berkas yang belum ada dianggap kosong. */
21
+ export function readAgents(file) {
22
+ let raw;
23
+ try {
24
+ raw = readFileSync(file, "utf8");
25
+ }
26
+ catch (error) {
27
+ if (error.code === "ENOENT")
28
+ return [];
29
+ throw error;
30
+ }
31
+ try {
32
+ const data = JSON.parse(raw);
33
+ if (!Array.isArray(data.agents) || !data.agents.every(isAgent))
34
+ throw new Error("bentuk tidak dikenal");
35
+ return data.agents;
36
+ }
37
+ catch (error) {
38
+ throw new Error(`registry rusak: ${file}: ${error.message}`);
39
+ }
40
+ }
41
+ function writeAgents(file, agents) {
42
+ mkdirSync(dirname(file), { recursive: true });
43
+ // Tulis ke berkas sementara lalu ganti nama, supaya pembaca tidak pernah melihat berkas setengah jadi.
44
+ const temp = `${file}.${process.pid}.tmp`;
45
+ writeFileSync(temp, `${JSON.stringify({ agents }, null, 2)}\n`);
46
+ renameSync(temp, file);
47
+ }
48
+ export function registerAgent(file, agent) {
49
+ if (!NAME.test(agent.name))
50
+ throw new Error(`nama agent "${agent.name}" tidak valid: huruf kecil, angka, atau "-", diawali huruf, maksimal 30 karakter`);
51
+ const agents = readAgents(file);
52
+ if (agents.some((a) => a.name === agent.name))
53
+ throw new Error(`agent "${agent.name}" sudah terdaftar`);
54
+ const dipakai = agents.find((a) => a.tmux === agent.tmux);
55
+ if (dipakai)
56
+ throw new Error(`pane ${agent.tmux} sudah dipakai agent "${dipakai.name}"`);
57
+ writeAgents(file, [...agents, agent]);
58
+ }
59
+ /** Mengembalikan `true` bila agent ada dan terhapus. */
60
+ export function removeAgent(file, name) {
61
+ const agents = readAgents(file);
62
+ const sisa = agents.filter((a) => a.name !== name);
63
+ if (sisa.length === agents.length)
64
+ return false;
65
+ writeAgents(file, sisa);
66
+ return true;
67
+ }
68
+ /** Memperbarui bidang agent (mis. hasil probe); galat bila agent tidak ada. */
69
+ export function updateAgent(file, name, fields) {
70
+ const agents = readAgents(file);
71
+ const index = agents.findIndex((a) => a.name === name);
72
+ if (index < 0)
73
+ throw new Error(`agent "${name}" tidak terdaftar`);
74
+ const baru = { ...agents[index], ...fields };
75
+ agents[index] = baru;
76
+ writeAgents(file, agents);
77
+ return baru;
78
+ }
@@ -0,0 +1,38 @@
1
+ import { RempugError } from "./errors.js";
2
+ /** Status tempat balasan agent masih diterima. */
3
+ const BISA_DIBALAS = [
4
+ "berjalan",
5
+ "menunggu-klarifikasi",
6
+ "macet",
7
+ ];
8
+ const RINGKASAN_BARIS = 12;
9
+ const RINGKASAN_LEBAR = 200;
10
+ /** Baris tidak kosong pertama, dibatasi jumlah dan lebarnya; detail lengkap tetap tersimpan terpisah. */
11
+ function ringkas(teks) {
12
+ return teks
13
+ .split("\n")
14
+ .map((l) => l.trim())
15
+ .filter(Boolean)
16
+ .slice(0, RINGKASAN_BARIS)
17
+ .map((l) => l.length > RINGKASAN_LEBAR ? `${l.slice(0, RINGKASAN_LEBAR - 1)}…` : l)
18
+ .join("\n");
19
+ }
20
+ /** Menyimpan balasan agent dan memulai verifikasi (atau menandai gagal bila `--gagal`). */
21
+ export function reply(ledger, id, teks, options) {
22
+ const task = ledger.getTask(id);
23
+ if (!task)
24
+ throw new RempugError(`tugas T${id} tidak ada`);
25
+ if (!BISA_DIBALAS.includes(task.status))
26
+ throw new RempugError(`tugas T${id} berstatus ${task.status}; balasan ditolak`);
27
+ const ringkasan = ringkas(teks);
28
+ ledger.saveReply(id, ringkasan, teks);
29
+ if (options.gagal) {
30
+ ledger.setStatus(id, "gagal");
31
+ const alasan = (ringkasan.split("\n")[0] ?? "").slice(0, 120);
32
+ ledger.addEvent(id, "gagal", `T${id} ${task.agent} ✗ gagal: ${alasan}`);
33
+ return { status: "gagal" };
34
+ }
35
+ ledger.setStatus(id, "memverifikasi");
36
+ options.spawnVerify(id);
37
+ return { status: "memverifikasi" };
38
+ }
@@ -0,0 +1,206 @@
1
+ const MAKS_PER_KELOMPOK = 10;
2
+ function hasilVerifikasi(task) {
3
+ return task.verify ? JSON.parse(task.verify) : undefined;
4
+ }
5
+ const indent = (teks) => teks
6
+ .split("\n")
7
+ .map((l) => ` ${l}`)
8
+ .join("\n");
9
+ /** Satu baris per tugas: hasil verifikasi bila ada, selain itu status singkat. */
10
+ export function barisLog(task) {
11
+ const hasil = hasilVerifikasi(task);
12
+ if (hasil)
13
+ return hasil.linha;
14
+ const kepala = `T${task.id} ${task.agent}`;
15
+ if (task.status === "gagal") {
16
+ const alasan = (task.replySummary ?? "").split("\n")[0] ?? "";
17
+ return alasan ? `${kepala} ✗ gagal: ${alasan}` : `${kepala} ✗ gagal`;
18
+ }
19
+ return task.flag
20
+ ? `${kepala} ${task.status} (${task.flag})`
21
+ : `${kepala} ${task.status}`;
22
+ }
23
+ /** Ringkasan satu tugas; `penuh` menambah brief, balasan lengkap, daftar perubahan, dan ekor cek yang gagal. */
24
+ export function formatShow(task, penuh) {
25
+ const bagian = [
26
+ `T${task.id} ${task.agent} ${task.status} (${task.mode})`,
27
+ barisLog(task),
28
+ ];
29
+ if (task.replySummary)
30
+ bagian.push(`ringkasan:\n${indent(task.replySummary)}`);
31
+ if (!penuh)
32
+ return bagian.join("\n");
33
+ bagian.push(`brief:\n${indent(task.brief.trim())}`);
34
+ if (task.replyDetail)
35
+ bagian.push(`balasan lengkap:\n${indent(task.replyDetail)}`);
36
+ const hasil = hasilVerifikasi(task);
37
+ if (hasil?.perubahan.length)
38
+ bagian.push(`perubahan:\n${indent(hasil.perubahan.map((f) => `${f.status} ${f.path} +${f.plus}/−${f.minus}${f.biner ? " (biner)" : ""}`).join("\n"))}`);
39
+ for (const cek of hasil?.cek ?? [])
40
+ if (!cek.ok)
41
+ bagian.push(`cek gagal ${cek.label}:\n${indent(cek.ekor)}`);
42
+ return bagian.join("\n");
43
+ }
44
+ const SELESAI = ["selesai"];
45
+ const GAGAL = ["gagal", "gagal-paham", "pelanggaran", "bentrok"];
46
+ const BLOCKER_STATUS = [
47
+ "macet",
48
+ "menunggu-klarifikasi",
49
+ "pelanggaran",
50
+ "gagal-paham",
51
+ ];
52
+ const BLOCKER_FLAG = ["menunggu-izin", "bertanya", "diterima-tanpa-ack"];
53
+ function kelompok(tasks) {
54
+ return {
55
+ selesai: tasks.filter((t) => SELESAI.includes(t.status)),
56
+ berjalan: tasks.filter((t) => t.status === "berjalan" ||
57
+ t.status === "memverifikasi" ||
58
+ t.status === "antri"),
59
+ gagal: tasks.filter((t) => GAGAL.includes(t.status)),
60
+ blocker: tasks.filter((t) => BLOCKER_STATUS.includes(t.status) ||
61
+ (t.status === "berjalan" &&
62
+ t.flag !== undefined &&
63
+ BLOCKER_FLAG.includes(t.flag))),
64
+ };
65
+ }
66
+ /** Laporan teks ringkas per repo: selesai, berjalan, gagal, dan blocker; daftar panjang dipotong. */
67
+ export function formatLaporan(repo, tasks) {
68
+ if (tasks.length === 0)
69
+ return `laporan rempug ${repo}\nbelum ada tugas`;
70
+ const k = kelompok(tasks);
71
+ const bagian = [`laporan rempug ${repo}`];
72
+ for (const [nama, daftar] of Object.entries(k)) {
73
+ if (daftar.length === 0)
74
+ continue;
75
+ const baris = daftar
76
+ .slice(0, MAKS_PER_KELOMPOK)
77
+ .map((t) => ` ${barisLog(t)}`);
78
+ if (daftar.length > MAKS_PER_KELOMPOK)
79
+ baris.push(` +${daftar.length - MAKS_PER_KELOMPOK} lagi`);
80
+ bagian.push(`${nama} (${daftar.length})\n${baris.join("\n")}`);
81
+ }
82
+ return bagian.join("\n");
83
+ }
84
+ export function formatLaporanMd(repo, tasks) {
85
+ const k = kelompok(tasks);
86
+ const bagian = [`# Laporan rempug\n\nRepo: \`${repo}\``];
87
+ for (const [nama, daftar] of Object.entries(k)) {
88
+ if (daftar.length === 0)
89
+ continue;
90
+ const judul = nama[0]?.toUpperCase() + nama.slice(1);
91
+ bagian.push(`## ${judul} (${daftar.length})\n\n${daftar.map((t) => `- ${barisLog(t)}`).join("\n")}`);
92
+ }
93
+ if (tasks.length === 0)
94
+ bagian.push("Belum ada tugas.");
95
+ return `${bagian.join("\n\n")}\n`;
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
+ }
@@ -0,0 +1,58 @@
1
+ import { listPanes } from "./tmux.js";
2
+ /** Perintah yang dikenali sebagai agent CLI; juga menjadi `jenis`. */
3
+ const KNOWN_KINDS = new Set(["codex", "agy", "claude", "gemini", "opencode"]);
4
+ /** Perintah yang bukan agent: editor, shell, dan pager. */
5
+ const EXCLUDED = new Set([
6
+ "nvim",
7
+ "vim",
8
+ "vi",
9
+ "bash",
10
+ "zsh",
11
+ "sh",
12
+ "fish",
13
+ "dash",
14
+ "less",
15
+ "htop",
16
+ "top",
17
+ "man",
18
+ "tmux",
19
+ ]);
20
+ function score(pane, repo) {
21
+ let skor = KNOWN_KINDS.has(pane.command) ? 3 : 0;
22
+ if (pane.path === repo)
23
+ skor += 2;
24
+ else if (pane.path.startsWith(`${repo}/`))
25
+ skor += 1;
26
+ return skor;
27
+ }
28
+ /** Memberi skor keyakinan tiap pane dan membuang pane orkestrator sendiri serta pane non-agent. */
29
+ export function scorePanes(panes, repo, selfPane) {
30
+ return panes
31
+ .filter((p) => p.paneId !== selfPane && !EXCLUDED.has(p.command))
32
+ .map((p) => {
33
+ const skor = score(p, repo);
34
+ return {
35
+ target: p.target,
36
+ sesi: p.session,
37
+ perintah: p.command,
38
+ direktori: p.path,
39
+ jenis: KNOWN_KINDS.has(p.command) ? p.command : "tidak-diketahui",
40
+ skor,
41
+ keyakinan: (skor >= 3
42
+ ? "tinggi"
43
+ : skor >= 1
44
+ ? "sedang"
45
+ : "rendah"),
46
+ };
47
+ })
48
+ .sort((a, b) => b.skor - a.skor || a.target.localeCompare(b.target));
49
+ }
50
+ export function scan(repo, options = {}) {
51
+ // ID pane hanya unik dalam satu server, jadi `$TMUX_PANE` tidak berarti untuk socket lain.
52
+ const selfPane = options.selfPane ??
53
+ (options.tmux?.socket ? undefined : process.env.TMUX_PANE);
54
+ return {
55
+ repo,
56
+ kandidat: scorePanes(listPanes(options.tmux), repo, selfPane),
57
+ };
58
+ }