rempug 0.0.0-stage → 0.1.0

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,42 @@
1
+ import { readAgents, registerAgent } from "./registry.js";
2
+ import { listPanes } from "./tmux.js";
3
+ /** Mendaftarkan agent setelah memastikan pane-nya ada di tmux. */
4
+ export function register(file, agent, tmux) {
5
+ if (!listPanes(tmux).some((p) => p.target === agent.tmux))
6
+ throw new Error(`pane "${agent.tmux}" tidak ada di tmux`);
7
+ registerAgent(file, agent);
8
+ return agent;
9
+ }
10
+ /** Satu baris per agent terdaftar, dengan status dari tmux dan ledger. */
11
+ export function agentRows(file, ledger, tmux) {
12
+ const targets = new Set(listPanes(tmux).map((p) => p.target));
13
+ return readAgents(file).map((agent) => {
14
+ if (!targets.has(agent.tmux))
15
+ return { ...agent, status: "hilang", tugas: undefined };
16
+ const aktif = ledger.activeTaskOf(agent.name);
17
+ return aktif
18
+ ? { ...agent, status: "sibuk", tugas: aktif.id }
19
+ : { ...agent, status: "siap", tugas: undefined };
20
+ });
21
+ }
22
+ /** Agent yang boleh menerima tugas; menolak yang tidak terdaftar atau sesinya hilang. */
23
+ export function requireAvailable(rows, name) {
24
+ const row = rows.find((r) => r.name === name);
25
+ if (!row)
26
+ throw new Error(`agent "${name}" tidak terdaftar`);
27
+ if (row.tidakAndal)
28
+ throw new Error(`agent "${name}" tidak andal (gagal probe); jalankan /rempug untuk mengujinya lagi`);
29
+ if (row.status === "hilang")
30
+ throw new Error(`agent "${name}" hilang: pane ${row.tmux} tidak ada lagi di tmux`);
31
+ return row;
32
+ }
33
+ export function formatAgentRow(row) {
34
+ const status = row.tidakAndal ? "tidak-andal" : row.status;
35
+ const kemampuan = row.capabilities.length ? row.capabilities.join(",") : "-";
36
+ const tugas = row.tugas === undefined ? "" : ` T${row.tugas}`;
37
+ const ack = row.ukur?.ackMs === undefined
38
+ ? ""
39
+ : ` ack ${(row.ukur.ackMs / 1000).toFixed(1)}s`;
40
+ const catatan = row.tidakAndal && row.catatan ? ` — ${row.catatan}` : "";
41
+ return `${row.name.padEnd(10)}${status} ${kemampuan}${tugas}${ack}${catatan}`;
42
+ }
@@ -0,0 +1,21 @@
1
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
2
+ /**
3
+ * Cadangan bila tool Monitor tidak ada: mengetik satu baris ke pane orkestrator, hanya saat pane itu idle
4
+ * (layar tidak berubah), supaya tidak bercampur dengan ketikan atau keluaran yang sedang berjalan.
5
+ */
6
+ export async function bangunkan(opsi) {
7
+ const { transport, target } = opsi;
8
+ try {
9
+ // Perbandingan mentah, bukan hashLayar: untuk menyuntik teks, timer yang berjalan pun berarti pane sibuk.
10
+ const awal = transport.tampak(target).baris.join("\n");
11
+ await sleep(opsi.jedaMs ?? 400);
12
+ const akhir = transport.tampak(target).baris.join("\n");
13
+ if (awal !== akhir)
14
+ return false;
15
+ await transport.kirim(target, `[rempug] ${opsi.baris}`);
16
+ return true;
17
+ }
18
+ catch {
19
+ return false;
20
+ }
21
+ }
@@ -0,0 +1,91 @@
1
+ import { parseSections } from "./sections.js";
2
+ export const SECTIONS = [
3
+ "TUJUAN",
4
+ "CAKUPAN",
5
+ "LANGKAH",
6
+ "CEK",
7
+ "BALASAN",
8
+ ];
9
+ const LANGKAH_BARIS = /^\s*\d+[.)]\s+(.*)$/;
10
+ function parsePath(raw) {
11
+ const path = raw.replace(/^(\.\/)+/, "");
12
+ if (!path || path.startsWith("/") || path.startsWith("-"))
13
+ return undefined;
14
+ return path.split("/").includes("..") ? undefined : path;
15
+ }
16
+ function parseCakupan(text, errors) {
17
+ const [mode, ...rest] = text.split(/[\s,]+/).filter(Boolean);
18
+ if ((mode === "baca" || mode === "browser") && rest.length === 0)
19
+ return { mode };
20
+ if (mode === "edit") {
21
+ if (rest.length === 0) {
22
+ errors.push("CAKUPAN: mode edit wajib menyebut minimal satu path");
23
+ return undefined;
24
+ }
25
+ const paths = rest.map(parsePath);
26
+ const buruk = rest.filter((_, i) => paths[i] === undefined);
27
+ if (buruk.length > 0) {
28
+ errors.push(`CAKUPAN: path tidak valid (harus relatif terhadap repo, tanpa "..", tidak diawali "-"): ${buruk.join(", ")}`);
29
+ return undefined;
30
+ }
31
+ return { mode, paths: paths };
32
+ }
33
+ errors.push('CAKUPAN harus "edit <path...>", "baca", atau "browser"');
34
+ return undefined;
35
+ }
36
+ function parseLangkah(text, errors) {
37
+ const langkah = [];
38
+ for (const line of text.split("\n")) {
39
+ if (!line.trim())
40
+ continue;
41
+ const nomor = LANGKAH_BARIS.exec(line);
42
+ if (nomor)
43
+ langkah.push((nomor[1] ?? "").trim());
44
+ else if (langkah.length > 0)
45
+ langkah[langkah.length - 1] += ` ${line.trim()}`;
46
+ else {
47
+ errors.push('LANGKAH harus bernomor, mis. "1. buka halaman"');
48
+ return [];
49
+ }
50
+ }
51
+ return langkah;
52
+ }
53
+ /** Mengurai dan memvalidasi brief; semua kekurangan dilaporkan sekaligus. */
54
+ export function parseBrief(text) {
55
+ const { body: found, errors } = parseSections(text, SECTIONS);
56
+ const body = new Map();
57
+ for (const section of SECTIONS) {
58
+ const content = found.get(section);
59
+ if (content)
60
+ body.set(section, content);
61
+ else
62
+ errors.push(`bagian ${section} hilang atau kosong`);
63
+ }
64
+ const cakupan = body.has("CAKUPAN")
65
+ ? parseCakupan(body.get("CAKUPAN"), errors)
66
+ : undefined;
67
+ const langkah = body.has("LANGKAH")
68
+ ? parseLangkah(body.get("LANGKAH"), errors)
69
+ : [];
70
+ const cekText = body.get("CEK");
71
+ const cek = cekText === undefined || /^(-|tidak ada)$/i.test(cekText)
72
+ ? []
73
+ : cekText
74
+ .split("\n")
75
+ .map((l) => l.trim())
76
+ .filter(Boolean);
77
+ if (cekText !== undefined && cakupan?.mode === "edit" && cek.length === 0)
78
+ errors.push("CEK wajib berisi minimal satu perintah untuk tugas edit");
79
+ if (errors.length > 0 || !cakupan)
80
+ return { ok: false, errors };
81
+ return {
82
+ ok: true,
83
+ brief: {
84
+ tujuan: body.get("TUJUAN"),
85
+ cakupan,
86
+ langkah,
87
+ cek,
88
+ balasan: body.get("BALASAN"),
89
+ },
90
+ };
91
+ }
@@ -0,0 +1,34 @@
1
+ import { readFileSync, writeFileSync } from "node:fs";
2
+ import { isAbsolute, relative, resolve } from "node:path";
3
+ import { RempugError, UsageError } from "./errors.js";
4
+ const escapeRegex = (teks) => teks.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
5
+ /**
6
+ * Mencentang satu item `tasks.md` (`berkas#nomor`, mis. `spec/tasks.md#2.1`): hanya baris itu yang berubah
7
+ * dari `- [ ]` menjadi `- [x]`. Mengembalikan `false` bila item sudah tercentang.
8
+ */
9
+ export function centangItem(spesifikasi, repo) {
10
+ const [berkas, nomor, ...lebih] = spesifikasi.split("#");
11
+ if (!berkas || !nomor || lebih.length > 0)
12
+ throw new UsageError(`--centang harus berbentuk berkas#nomor, mis. spec/tasks.md#2.1 (diterima: ${spesifikasi})`);
13
+ const path = resolve(repo, berkas);
14
+ const rel = relative(repo, path);
15
+ if (isAbsolute(berkas) || rel.startsWith("..") || isAbsolute(rel))
16
+ throw new UsageError(`${berkas} di luar repo; --centang hanya untuk berkas di dalam repo`);
17
+ let isi;
18
+ try {
19
+ isi = readFileSync(path, "utf8");
20
+ }
21
+ catch {
22
+ throw new RempugError(`berkas ${berkas} tidak ada`);
23
+ }
24
+ // Nomor tingkat atas ditulis "2." sedangkan sub-item "2.1"; "2" tidak boleh cocok dengan "2.1".
25
+ const belum = new RegExp(`^(\\s*- )\\[ \\] (${escapeRegex(nomor)}(?:\\.(?=\\s)|(?=\\s)))`, "m");
26
+ const sudah = new RegExp(`^\\s*- \\[x\\] ${escapeRegex(nomor)}(?:\\.(?=\\s)|(?=\\s))`, "m");
27
+ if (!belum.test(isi)) {
28
+ if (sudah.test(isi))
29
+ return false;
30
+ throw new RempugError(`item ${nomor} tidak ditemukan di ${berkas}`);
31
+ }
32
+ writeFileSync(path, isi.replace(belum, "$1[x] $2"));
33
+ return true;
34
+ }
@@ -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
+ }