minicode-ai 0.27.0 → 0.30.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.
Files changed (145) hide show
  1. package/README.md +1 -1
  2. package/cli/args.ts +184 -57
  3. package/cli/bootstrap/presentation-bridge.ts +383 -0
  4. package/cli/commands/acp.ts +45 -29
  5. package/cli/commands/auth.ts +17 -17
  6. package/cli/commands/config.ts +65 -66
  7. package/cli/commands/daemon.ts +44 -16
  8. package/cli/commands/doctor.ts +18 -15
  9. package/cli/commands/exec.ts +41 -89
  10. package/cli/commands/mcp.ts +25 -8
  11. package/cli/commands/memory.ts +16 -24
  12. package/cli/commands/openwork.ts +6 -2
  13. package/cli/commands/pricing.ts +14 -12
  14. package/cli/commands/providers.ts +36 -57
  15. package/cli/commands/sessions.ts +24 -18
  16. package/cli/commands/skills.ts +33 -18
  17. package/cli/commands/stats.ts +15 -30
  18. package/cli/commands.ts +73 -44
  19. package/cli/context-command-run.ts +30 -18
  20. package/cli/index.ts +51 -100
  21. package/cli/model-manager.ts +7 -2
  22. package/cli/provider-manager.ts +33 -18
  23. package/cli/router.ts +41 -12
  24. package/cli/setup.ts +241 -485
  25. package/cli/tui.ts +303 -100
  26. package/docs/TERMINAL_CONTRACT.md +258 -73
  27. package/docs/UI_RENDER_PIPELINE.md +9 -1
  28. package/docs/agents.md +2 -2
  29. package/docs/architecture.md +17 -32
  30. package/docs/choosing-mode.md +7 -9
  31. package/docs/cli.md +3 -5
  32. package/docs/environment.md +1 -2
  33. package/docs/policy-sandbox.md +3 -3
  34. package/docs/repl.md +2 -2
  35. package/docs/tools.md +1 -1
  36. package/package.json +1 -1
  37. package/src/app/mentions.ts +60 -13
  38. package/src/app/rag-layer.ts +17 -20
  39. package/src/app/session.ts +144 -68
  40. package/src/app/tool-layer.ts +38 -16
  41. package/src/config.ts +64 -104
  42. package/src/constants.ts +4 -6
  43. package/src/daemon/capability.ts +8 -1
  44. package/src/daemon/control.ts +3 -2
  45. package/src/daemon/server.ts +57 -0
  46. package/src/hooks/run.ts +73 -41
  47. package/src/lib/atomic-write.ts +31 -59
  48. package/src/lib/db-path.ts +47 -0
  49. package/src/lib/process-tree.ts +62 -0
  50. package/src/lib/public-http.ts +88 -23
  51. package/src/lib/trusted-exec.ts +48 -1
  52. package/src/lsp/client.ts +62 -17
  53. package/src/mcp/client.ts +85 -38
  54. package/src/mcp/http-transport.ts +28 -16
  55. package/src/mcp/transport.ts +42 -6
  56. package/src/memory/files.ts +164 -134
  57. package/src/memory/vector.ts +371 -420
  58. package/src/policy/approval-binding.ts +122 -45
  59. package/src/policy/bash-guard.ts +18 -7
  60. package/src/policy/compaction.ts +51 -18
  61. package/src/policy/context-window.ts +31 -8
  62. package/src/policy/context.ts +62 -36
  63. package/src/policy/executor.ts +17 -7
  64. package/src/policy/jail.ts +6 -8
  65. package/src/policy/microcompact.ts +4 -3
  66. package/src/policy/no-progress.ts +103 -22
  67. package/src/policy/permission.ts +36 -12
  68. package/src/policy/tool-contract.ts +74 -416
  69. package/src/policy/usage.ts +24 -2
  70. package/src/policy/verifier.ts +50 -2
  71. package/src/policy/work-mode.ts +28 -54
  72. package/src/presentation/adapter.ts +24 -16
  73. package/src/providers/anthropic.ts +16 -5
  74. package/src/providers/provision.ts +6 -56
  75. package/src/providers/responses.ts +38 -7
  76. package/src/providers/sse-bounds.ts +6 -4
  77. package/src/runtime/execution-journal.ts +4 -29
  78. package/src/sandbox/docker.ts +58 -34
  79. package/src/sandbox/mask.ts +157 -0
  80. package/src/sandbox/os.ts +107 -73
  81. package/src/session/authority.ts +29 -10
  82. package/src/session/context-projection.ts +6 -5
  83. package/src/session/db/runs.ts +397 -0
  84. package/src/session/db/schema.ts +358 -0
  85. package/src/session/open-work.ts +26 -3
  86. package/src/session/persistence.ts +74 -998
  87. package/src/session/verification.ts +170 -20
  88. package/src/skills/loader.ts +31 -16
  89. package/src/task/db/schema.ts +325 -0
  90. package/src/task/db/types.ts +269 -0
  91. package/src/task/production-scheduler.ts +13 -1
  92. package/src/task/store.ts +92 -1021
  93. package/src/telemetry/trace.ts +27 -0
  94. package/src/tools/ask_user.ts +1 -13
  95. package/src/tools/bash.ts +27 -92
  96. package/src/tools/code_run.ts +1 -1
  97. package/src/tools/context.ts +133 -0
  98. package/src/tools/delete_file.ts +3 -2
  99. package/src/tools/edit.ts +37 -72
  100. package/src/tools/git.ts +86 -9
  101. package/src/tools/glob.ts +26 -51
  102. package/src/tools/grep.ts +67 -57
  103. package/src/tools/hashline.ts +4 -0
  104. package/src/tools/lsp.ts +11 -8
  105. package/src/tools/mcp_call.ts +9 -6
  106. package/src/tools/memory.ts +56 -33
  107. package/src/tools/move_file.ts +36 -10
  108. package/src/tools/patch.ts +13 -21
  109. package/src/tools/read_file.ts +18 -25
  110. package/src/tools/read_image.ts +35 -33
  111. package/src/tools/submit_result.ts +29 -8
  112. package/src/tools/task.ts +74 -17
  113. package/src/tools/todo.ts +181 -74
  114. package/src/tools/web_fetch.ts +42 -2
  115. package/src/tools/web_search.ts +47 -8
  116. package/src/ui/approval/prompt.ts +206 -47
  117. package/src/ui/assistant/turn-status.ts +14 -5
  118. package/src/ui/footer.ts +4 -4
  119. package/src/ui/i18n/en.ts +47 -23
  120. package/src/ui/i18n/id.ts +76 -51
  121. package/src/ui/input/input.ts +4 -3
  122. package/src/ui/input/prompt-engine.ts +35 -5
  123. package/src/ui/render/activity-panel.ts +4 -2
  124. package/src/ui/render/hint.ts +7 -4
  125. package/src/ui/render/list.ts +32 -0
  126. package/src/ui/render/markdown.ts +6 -3
  127. package/src/ui/render/notice.ts +19 -0
  128. package/src/ui/render/table-grid.ts +7 -8
  129. package/src/ui/render/theme.ts +113 -39
  130. package/src/ui/runtime/screen.ts +74 -10
  131. package/src/ui/runtime/spinner.ts +19 -6
  132. package/src/ui/screens/dialog.ts +19 -1
  133. package/src/ui/screens/form.ts +80 -35
  134. package/src/ui/screens/model-manager.ts +82 -61
  135. package/src/ui/screens/output-window.ts +263 -0
  136. package/src/ui/screens/picker.ts +94 -81
  137. package/src/ui/screens/provider-manager.ts +100 -69
  138. package/src/ui/screens/wizard.ts +117 -28
  139. package/src/ui/tui/app.ts +196 -33
  140. package/src/ui/tui/transcript.ts +158 -25
  141. package/vendor/minicore/src/core/executor.ts +2 -0
  142. package/vendor/minicore/src/core/loop.ts +17 -6
  143. package/vendor/minicore/src/core/session.ts +3 -0
  144. package/vendor/minicore/src/core/tool.ts +1 -0
  145. package/vendor/minicore/src/providers/openai-compat.ts +35 -19
@@ -1,8 +1,7 @@
1
1
  import { Database } from "bun:sqlite"
2
2
  import { createHash, randomUUID } from "node:crypto"
3
3
  import { existsSync } from "node:fs"
4
- import { LIMITS } from "../constants.ts"
5
- import { resolveDbPath, resolveLocalDbPath } from "../lib/db-path.ts"
4
+ import { isSqliteContention } from "../lib/db-path.ts"
6
5
  import { scrubSecrets } from "../policy/scrub.ts"
7
6
  import { type DomainEvent, DURABILITY, EVENT_SCHEMA_VERSION } from "../presentation/events.ts"
8
7
 
@@ -11,561 +10,69 @@ import { type DomainEvent, DURABILITY, EVENT_SCHEMA_VERSION } from "../presentat
11
10
  // tetapi salah untuk state per-workspace (offset konsumen & persetujuan
12
11
  // daemon): proyek A yang "melanjutkan" dari progres proyek B adalah bocoran
13
12
  // scope yang tak pernah bisa dilihat pemakai.
14
- const dbPath = (cwd?: string, local = false) =>
15
- local ? resolveLocalDbPath("sessions.db", cwd) : resolveDbPath("sessions.db", cwd)
16
-
17
- const initializedSessionPaths = new Set<string>()
18
-
19
- // [Audit #2 C.F1] Gate DDL/migrasi per path. `initializedSessionPaths` hanya
20
- // men-gate PRAGMA WAL; ~30 statement DDL (CREATE TABLE IF NOT EXISTS, PRAGMA
21
- // table_info, ALTER TABLE) TIDAK di-gate di jalur lama, sehingga dijalankan
22
- // ulang di setiap `open()` (50 call site). Set ini menandai path yang SKEMA-nya
23
- // sudah jadi, asal marker migrasi terakhir (kolom daemon_approvals.invocation_id)
24
- // masih ada di koneksi.
25
- const migratedSessionPaths = new Set<string>()
26
-
27
- /**
28
- * [Audit #2 C.F1] Cek tanda migrasi SELESAI di koneksi saat ini (bukan cache
29
- * lintas-handle). Marker = kolom `daemon_approvals.invocation_id` (kolom PALING
30
- * AKHIR yang ditambahkan migrasi). Cek KOLOM — bukan sekadar keberadaan tabel —
31
- * karena test migrasi menurunkan DB lama dengan DROP COLUMN: tabel `daemon_approvals`
32
- * tetap ada tapi kolom pengikatnya hilang, dan harus di-ALTER ulang.
33
- */
34
- function daemonApprovalsMigrated(db: Database): boolean {
35
- try {
36
- const cols = db.prepare("PRAGMA table_info(daemon_approvals)").all() as { name: string }[]
37
- if (!cols.some((c) => c.name === "invocation_id")) return false
38
- const sessCols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
39
- return sessCols.some((c) => c.name === "work_mode")
40
- } catch {
41
- return false
42
- }
43
- }
44
-
45
- /**
46
- * Retry sinkron untuk blok setup schema di `open()`.
47
- *
48
- * Ditemukan oleh test baseline Phase 0: `open()` menjalankan
49
- * `CREATE TABLE IF NOT EXISTS` TANPA pagar retry, padahal `busy_timeout` sudah
50
- * diset. Akibatnya satu penulis yang lock-nya ditahan membuat PEMBUKA DB
51
- * melempar SQLITE_BUSY — dan itu terjadi SEBELUM `withBusyRetry` di
52
- * `appendPresentationEvents` sempat dipanggil. Jadi jalur retry yang ada tidak
53
- * pernah menyelamatkan operasi yang paling butuh: DB-nya sendiri belum siap.
54
- *
55
- * `withBusyRetry` (async) tidak bisa dipakai di sini karena `open()` sinkron
56
- * dan dipanggil dari jalur sinkron (`loadSession`, `listSessions`, dst).
57
- */
58
- // Konstanta retry inisialisasi DB. Naikkan dari 3 (baseline) ke 8 dengan
59
- // backoff exponential + jitter kecil agar tahan terhadap lonjakan proses
60
- // paralel di Windows/POSIX (temuan Live #1: dua CLI paralel → SQLITE_BUSY
61
- // saat `new Database(p)` + PRAGMA setup, salah satu proses gagal di
62
- // `cli/router.ts`). Backoff: 15+0, 30+j, 60+j, 120+j, 240+j, 480+j, 960+j,
63
- // 1920+j ms → total ≤ ~3,8 dtk untuk 8 percobaan, masih di bawah budget
64
- // startup. Jitter memecah sinkronisasi antar-proses yang mencoba ulang
65
- // pada waktu yang sama (thundering herd).
66
- const DB_INIT_ATTEMPTS = 8
67
- const DB_INIT_BACKOFF_MS = 15
68
-
69
- function dbInitBackoffMs(attempt: number): number {
70
- const base = DB_INIT_BACKOFF_MS * 2 ** attempt
71
- // jitter deterministik kecil (±20%) dari attempt ke-2 dst; attempt pertama
72
- // (i=0) tidak dijitter agar kasus SQLITE_BUSY tunggal tetap selesai secepat
73
- // mungkin (tanpa menambah latensi startup untuk jalur yang TIDAK balapan).
74
- if (attempt === 0) return base
75
- return base + ((attempt * 7919 + 3) % Math.max(1, Math.floor(base * 0.2)))
76
- }
77
-
78
- // [Phase 12.2] Predikat kontensi SQLite transien lintas-proses (buka/WAL di
79
- // Windows). Sebelumnya hanya SQLITE_BUSY/"database is locked" yang di-retry; di
80
- // Windows, dua proses yang membuka WAL bersamaan di bawah beban disk tinggi juga
81
- // melempar SQLITE_IOERR_TRUNCATE / SQLITE_IOERR_SHMOPEN / SQLITE_IOERR_LOCK /
82
- // SQLITE_PROTOCOL / SQLITE_LOCKED — semuanya transien (kompetisi lock), bukan
83
- // korupsi, dan AMAN di-retry. Bun menaruh kode simbolik di `error.code` dan teks
84
- // manusiawi di `error.message` (mis. SQLITE_BUSY = "database is locked",
85
- // SQLITE_IOERR_* = "disk I/O error" atau kode extended), jadi keduanya diperiksa.
86
- // SENGAJA TIDAK di-retry: SQLITE_CORRUPT / SQLITE_NOTADB / constraint error — retry
87
- // buta hanya menyembunyikan korupsi skema/data yang nyata.
88
- const SQLITE_CONTENTION_RE =
89
- /SQLITE_BUSY|database is locked|database table is locked|SQLITE_LOCKED|SQLITE_PROTOCOL|SQLITE_IOERR_TRUNCATE|SQLITE_IOERR_SHMOPEN|SQLITE_IOERR_LOCK|disk I\/O error/i
90
-
91
- function isSqliteContention(e: unknown): boolean {
92
- const code = (e as { code?: unknown } | null)?.code
93
- if (typeof code === "string" && SQLITE_CONTENTION_RE.test(code)) return true
94
- const msg = e instanceof Error ? String(e.message ?? e) : String(e)
95
- return SQLITE_CONTENTION_RE.test(msg)
96
- }
97
-
98
- export function withBusyRetrySync<T>(fn: () => T, attempts = DB_INIT_ATTEMPTS): T | null {
99
- let last: unknown
100
- for (let i = 0; i < attempts; i++) {
101
- try {
102
- return fn()
103
- } catch (e) {
104
- // [Phase 12.2] Retry hanya pada kontensi SQLite transien (lihat
105
- // isSqliteContention); korupsi (SQLITE_CORRUPT/NOTADB), constraint, dan
106
- // error non-kontensi lain dilempar segera.
107
- if (!isSqliteContention(e)) throw e
108
- last = e
109
- // Backoff sinkron eksponensial + jitter kecil (lihat dbInitBackoffMs).
110
- Bun.sleepSync(dbInitBackoffMs(i))
111
- }
112
- }
113
- process.stderr.write(
114
- `[warn] persistence: schema setup gave up after ${attempts} attempts: ${String((last as Error)?.message ?? last)}\n`,
115
- )
116
- return null
117
- }
118
-
119
- function open(cwd?: string, local = false): Database {
120
- const p = dbPath(cwd, local)
121
- // [Phase 7 / Live #1] Pembukaan koneksi + PRAGMA setup dibungkus dengan
122
- // withBusyRetrySync. Sebelumnya hanya DDL yang di-retry; `new Database(p)`
123
- // dan `PRAGMA journal_mode=WAL` bisa gagal SQLITE_BUSY saat dua proses CLI
124
- // paralel membuka DB bersamaan (race nyata saat dua proses CLI membuka DB). Dengan
125
- // membungkus seluruh urutan inisialisasi, proses yang kalah tunggu lalu
126
- // coba ulang sampai lock dilepas (backoff eksponensial + jitter, 8×).
127
- // PRAGMA busy_timeout DIATUR dalam retry yang sama SEBELUM journal_mode:
128
- // peralihan ke WAL butuh exclusive lock sesaat yang langsung gagal tanpa
129
- // busy_timeout aktif (audit #09 P1 §27).
130
- const db = withBusyRetrySync(() => {
131
- const d = new Database(p)
132
- try {
133
- d.exec(`PRAGMA busy_timeout=${LIMITS.SQLITE_BUSY_TIMEOUT_MS}`)
134
- } catch {}
135
- return d
136
- })
137
- if (!db) {
138
- throw new Error(
139
- `persistence: cannot open sessions.db after ${DB_INIT_ATTEMPTS} busy-retry attempts: ${p}`,
140
- )
141
- }
142
- // [Audit #3 RL-1] Seluruh langkah pasca-konstruksi (WAL + DDL/migrasi) dibungkus
143
- // agar kegagalan SQLITE_IOERR/CORRUPT menutup handle `Database` — bukan bocor.
144
- try {
145
- if (!initializedSessionPaths.has(p)) {
146
- // journal_size_limit + wal_autocheckpoint: WAL tidak tumbuh tak terbatas.
147
- // Bungkus try/catch DENGAN retry-next-open (audit 2026-09-16): di Windows,
148
- // lock AV/file sesaat saat dua proses membuka bersamaan membuat setup WAL
149
- // gagal SQLITE_IOERR_TRUNCATE — crash di sini mematikan SELURUH operasi
150
- // sesi padahal mode rollback-journal tetap bisa baca. Jangan tandai
151
- // initialized bila gagal agar open berikutnya mencoba lagi (mode WAL
152
- // persisten di berkas DB, jadi sekali sukses berlaku untuk semua handle).
153
- // Phase 7: PRAGMA setup ini juga dibungkus withBusyRetrySync karena
154
- // peralihan WAL butuh exclusive lock sesaat.
155
- const walOk = withBusyRetrySync(() => {
156
- db.exec(
157
- `PRAGMA journal_mode=WAL; PRAGMA busy_timeout=${LIMITS.SQLITE_BUSY_TIMEOUT_MS}; PRAGMA synchronous=NORMAL; PRAGMA journal_size_limit=${LIMITS.SQLITE_WAL_SIZE_LIMIT_BYTES}; PRAGMA wal_autocheckpoint=${LIMITS.SQLITE_WAL_AUTOCHECKPOINT_PAGES};`,
158
- )
159
- initializedSessionPaths.add(p)
160
- return true
161
- })
162
- if (walOk === null) {
163
- process.stderr.write(`[warn] persistence: wal setup deferred, retry next open: ${p}\n`)
164
- }
165
- // File DB dibuat dengan 644 default; ubah ke 600 agar history tidak world-readable
166
- try {
167
- const { chmodSync } = require("node:fs") as typeof import("node:fs")
168
- chmodSync(p, 0o600)
169
- // WAL/SHM akan dibuat dengan mode yang sama pada checkpoint berikutnya
170
- } catch {}
171
- }
172
- // [Audit #2 C.F1] DDL/migrasi DI-GATE per path: bila path sudah di-migrasi
173
- // DAN marker migrasi terakhir (kolom daemon_approvals.invocation_id) masih ada
174
- // di koneksi ini, lewati seluruh blok CREATE/ALTER. Cek KOLOM di koneksi saat
175
- // ini memastikan DB yang dihapus + dibuat ulang (atau kolom di-DROP oleh test
176
- // migrasi) TETAP di-migrasi ulang — Set hanya cache path, bukan handle Database.
177
- const needsDdl = !migratedSessionPaths.has(p) || !daemonApprovalsMigrated(db)
178
- if (needsDdl) {
179
- // DDL setup: `CREATE TABLE IF NOT EXISTS` butuh lock tulis bila tabel belum
180
- // ada. Tanpa retry di sini, DB yang sedang dikunci proses lain membuat
181
- // SETIAP operasi sesi gagal seketika. `null` = gagal terus; pemanggil akan
182
- // gagal di statement berikutnya dengan pesan yang lebih jelas.
183
- withBusyRetrySync(() => {
184
- db.exec(`
185
- CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, created_at INTEGER, cwd TEXT, system TEXT, writer_epoch INTEGER NOT NULL DEFAULT 0, default_thread_id TEXT NULL, work_mode TEXT NULL);
186
- CREATE TABLE IF NOT EXISTS messages (session_id TEXT, seq INTEGER, role TEXT, content TEXT, toolCalls TEXT, toolCallId TEXT, name TEXT, reasoning TEXT, is_error INTEGER, ts INTEGER, thread_id TEXT NULL, event_id TEXT NULL, run_id TEXT NULL, migrated INTEGER NOT NULL DEFAULT 0, migrated_compacted INTEGER NOT NULL DEFAULT 0, projection_note TEXT NULL, PRIMARY KEY(session_id, seq));
187
- CREATE TABLE IF NOT EXISTS turns (session_id TEXT, turn_idx INTEGER, usage TEXT, ts INTEGER, PRIMARY KEY(session_id, turn_idx));
188
- CREATE TABLE IF NOT EXISTS presentation_events (
189
- session_id TEXT NOT NULL,
190
- event_seq INTEGER NOT NULL,
191
- type TEXT NOT NULL,
192
- turn_id INTEGER NOT NULL,
193
- ts INTEGER NOT NULL,
194
- payload TEXT NOT NULL,
195
- PRIMARY KEY(session_id, event_seq)
196
- );
197
- CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id, seq);
198
- CREATE INDEX IF NOT EXISTS idx_presentation_events_session ON presentation_events(session_id, event_seq);
199
- `)
200
- })
201
- // migration: add updated_at, toolCallId, name jika kolom lama (backward-compat)
202
- try {
203
- const cols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
204
- if (!cols.some((c) => c.name === "updated_at")) {
205
- db.exec("ALTER TABLE sessions ADD COLUMN updated_at INTEGER")
206
- db.exec("UPDATE sessions SET updated_at = created_at WHERE updated_at IS NULL")
207
- }
208
- db.exec(`CREATE INDEX IF NOT EXISTS idx_sessions_updated ON sessions(updated_at DESC)`)
209
- // P2.9 — lineage Sub-Agent. Aditif + idempoten. NULL = sesi root (parent
210
- // ATAU anak legasi pra-P2.9). Sesi anak MEILIKI baris sessions sendiri;
211
- // ini yang menutup cacat namespace hantu (presentation_events.session_id
212
- // menunjuk id tanpa baris sessions → dihapus orphan-purge).
213
- if (!cols.some((c) => c.name === "parent_session_id")) {
214
- db.exec("ALTER TABLE sessions ADD COLUMN parent_session_id TEXT NULL")
215
- }
216
- if (!cols.some((c) => c.name === "parent_run_id")) {
217
- db.exec("ALTER TABLE sessions ADD COLUMN parent_run_id TEXT NULL")
218
- }
219
- // P0.2 (Q5): persistensi WorkMode di metadata sesi lintas `--resume`.
220
- // NULL = sesi legacy tanpa WorkMode tersimpan (resume fallback DISCUSS).
221
- if (!cols.some((c) => c.name === "work_mode")) {
222
- db.exec("ALTER TABLE sessions ADD COLUMN work_mode TEXT NULL")
223
- }
224
- db.exec(`CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id)`)
225
- } catch (e) {
226
- process.stderr.write(
227
- `[warn] persistence: sessions migration skipped: ${(e as Error).message}\n`,
228
- )
229
- }
230
- try {
231
- const msgCols = db.prepare("PRAGMA table_info(messages)").all() as { name: string }[]
232
- if (!msgCols.some((c) => c.name === "toolCallId")) {
233
- db.exec("ALTER TABLE messages ADD COLUMN toolCallId TEXT")
234
- db.exec("ALTER TABLE messages ADD COLUMN name TEXT")
235
- }
236
- // Fidelity resume: `reasoning` (thinking DeepSeek-style) dan `is_error`
237
- // (tool gagal) adalah bagian dari kernel Message dan ikut dibawa ke
238
- // history, tapi kolomnya tak pernah ada — resume lama sewajarnya buta dan
239
- // model kehilangan konteks kegagalannya. Additive, jadi DB lama tetap
240
- // terbaca dan turn lama (tanpa kolom ini) tetap resume dengan isError
241
- // diperlakukan absen.
242
- if (!msgCols.some((c) => c.name === "reasoning")) {
243
- db.exec("ALTER TABLE messages ADD COLUMN reasoning TEXT")
244
- }
245
- if (!msgCols.some((c) => c.name === "is_error")) {
246
- db.exec("ALTER TABLE messages ADD COLUMN is_error INTEGER")
247
- }
248
- } catch (e) {
249
- process.stderr.write(
250
- `[warn] persistence: messages migration skipped: ${(e as Error).message}\n`,
251
- )
252
- }
253
- // P2.1 — peta alias identitas sesi: alias (input mentah eksak) → kanonik.
254
- // Additive: DB lama mendapat tabel kosong; tak ada baris lama yang berubah.
255
- // `alias` = input mentah persis (bukan hasil sanitasi) agar tabrakan
256
- // sanitizer (`a/b` vs `a-b`) tetap terbedakan; `fs_key` = bentuk kanonik
257
- // untuk deteksi tabrakan kunci filesystem.
258
- withBusyRetrySync(() => {
259
- db.exec(`
260
- CREATE TABLE IF NOT EXISTS session_aliases (alias TEXT PRIMARY KEY, fs_key TEXT NOT NULL, canonical TEXT NOT NULL, reason TEXT NOT NULL, created_at INTEGER NOT NULL);
261
- CREATE INDEX IF NOT EXISTS idx_session_aliases_fs ON session_aliases(fs_key);
262
- CREATE INDEX IF NOT EXISTS idx_session_aliases_canonical ON session_aliases(canonical);
263
- `)
264
- })
265
- // P2.2 — pagar penulis (writer fence): generasi otoritas penulis dalam
266
- // satu generasi identitas sesi. BEDA dari inkarnasi TaskStore (generasi
267
- // identitas lintas delete/recreate): epoch hanya maju lewat takeover dan
268
- // tak pernah diubah save biasa. Baris lama → 0 (deterministik).
269
- // P2.3 — slot default_thread_id (nullable transisional; P2.4 menegakkan
270
- // invariant) + kolom dorman messages (NULL/0 = legacy tak-berskala;
271
- // P2.4 backfill, P2.5 alokator + UNIQUE event_id via index).
272
- try {
273
- const sessCols = db.prepare("PRAGMA table_info(sessions)").all() as { name: string }[]
274
- if (!sessCols.some((c) => c.name === "writer_epoch")) {
275
- db.exec("ALTER TABLE sessions ADD COLUMN writer_epoch INTEGER NOT NULL DEFAULT 0")
276
- }
277
- if (!sessCols.some((c) => c.name === "default_thread_id")) {
278
- db.exec("ALTER TABLE sessions ADD COLUMN default_thread_id TEXT NULL")
279
- }
280
- const msgCols2 = db.prepare("PRAGMA table_info(messages)").all() as { name: string }[]
281
- const addMsgCol = (name: string, ddl: string): void => {
282
- if (!msgCols2.some((c) => c.name === name))
283
- db.exec(`ALTER TABLE messages ADD COLUMN ${ddl}`)
284
- }
285
- addMsgCol("thread_id", "thread_id TEXT NULL")
286
- addMsgCol("event_id", "event_id TEXT NULL")
287
- addMsgCol("run_id", "run_id TEXT NULL")
288
- addMsgCol("migrated", "migrated INTEGER NOT NULL DEFAULT 0")
289
- addMsgCol("migrated_compacted", "migrated_compacted INTEGER NOT NULL DEFAULT 0")
290
- addMsgCol("projection_note", "projection_note TEXT NULL")
291
- // P2.6: takeover_epoch untuk runs (NULL = pra-P2.6; diisi saat create).
292
- try {
293
- const runCols = db.prepare("PRAGMA table_info(runs)").all() as { name: string }[]
294
- if (runCols.length > 0 && !runCols.some((c) => c.name === "takeover_epoch")) {
295
- db.exec("ALTER TABLE runs ADD COLUMN takeover_epoch INTEGER NULL")
296
- }
297
- } catch {
298
- // Tabel absen (handle mentah) atau gagal — CREATE di atas yang berlaku.
299
- }
300
- // P2.7: anchor_event_id untuk history_projections (NULL = pra-P2.7 atau
301
- // cakupan kosong; diisi saat build bila base_seq > 0). Aditif idempoten
302
- // seperti kolom di atas; baris lama (bila ada) dipertahankan utuh.
303
- try {
304
- const projCols = db.prepare("PRAGMA table_info(history_projections)").all() as {
305
- name: string
306
- }[]
307
- if (projCols.length > 0 && !projCols.some((c) => c.name === "anchor_event_id")) {
308
- db.exec("ALTER TABLE history_projections ADD COLUMN anchor_event_id TEXT NULL")
309
- }
310
- } catch {
311
- // Tabel absen atau gagal — CREATE di bawah yang berlaku.
312
- }
313
- // Indeks di SINI (setelah ALTER): CREATE INDEX atas kolom yang belum ada
314
- // melempar di DB legacy bila dikerjakan sebelum migrasi kolom (temuan
315
- // P2.3: open() gagal total). Idempoten seperti indeks lain di atas.
316
- // P2.4 — identitas histori kanonik (session_id, thread_id, seq): UNIQUE
317
- // (menggantikan idx_messages_thread P2.3 yang salah-bentuk tanpa
318
- // session_id). NULL thread legacy dikecualikan SQLite secara alami.
319
- // P2.5 — keunikan event: UNIQUE(session_id, thread_id, event_id).
320
- // NULL dikecualikan (baris legacy pra-backfill tak pernah konflik);
321
- // komposit (bukan global) agar branch PRESERVE event_id tetap konsisten
322
- // (masa lalu bersama = id sama di sesi berbeda — analogi objek git).
323
- db.exec("DROP INDEX IF EXISTS idx_messages_thread")
324
- withBusyRetrySync(() => {
325
- db.exec(`
326
- CREATE UNIQUE INDEX IF NOT EXISTS udx_messages_thread_seq ON messages(session_id, thread_id, seq);
327
- CREATE UNIQUE INDEX IF NOT EXISTS udx_messages_event_id ON messages(session_id, thread_id, event_id);
328
- CREATE INDEX IF NOT EXISTS idx_messages_run ON messages(run_id);
329
- `)
330
- })
331
- } catch (e) {
332
- process.stderr.write(
333
- `[warn] persistence: writer_epoch migration skipped: ${(e as Error).message}\n`,
334
- )
335
- }
336
- // P2.2 — rekaman takeover durable: SATU baris per (sesi, prior_epoch).
337
- // Keunikan inilah yang membuat takeover simultan punya tepat satu pemenang
338
- // (tanpa mengandalkan Date.now): pecundang menabrak constraint dan
339
- // mengamati hasil pemenang (idempoten), bukan menaikkan epoch lagi.
340
- withBusyRetrySync(() => {
341
- db.exec(`
342
- CREATE TABLE IF NOT EXISTS session_takeovers (session_id TEXT NOT NULL, prior_epoch INTEGER NOT NULL, new_epoch INTEGER NOT NULL, reason TEXT NOT NULL, boot TEXT NOT NULL, created_at INTEGER NOT NULL, PRIMARY KEY(session_id, prior_epoch));
343
- CREATE INDEX IF NOT EXISTS idx_session_takeovers_session ON session_takeovers(session_id);
344
- `)
345
- })
346
- // P2.3 — kerangka penyimpanan (STORAGE ONLY, tanpa semantik aktif).
347
- // Ketiga tabel + kolom dorman di bawah TIDAK ditulis/dibaca runtime mana
348
- // pun di fase ini; P2.4 (Thread), P2.5 (Run/kursor), P2.7 (proyeksi) yang
349
- // mengaktifkannya. Konvensi migrasi = DDL idempoten di open() (tanpa
350
- // user_version: semua perubahan aditif; restart-safe via idempotence,
351
- // bukan via atomisitas DDL — SQLite men-commit tiap statement).
352
- // P2.4 — koreksi identitas Thread: komposit (session_id, thread_id).
353
- // Skema P2.3 memakai thread_id PK global (satu 'th_default' sedunia —
354
- // mustahil). Identitas kanonik menurut blueprint adalah pasangan
355
- // (session, thread); runs/projections sudah membawa session_id. Rebuild
356
- // HANYA bila bentuk lama terdeteksi (di bawah); AMAN karena tabel P2.3
357
- // dijamin kosong (guard netralitas + assert menolak bila ada baris —
358
- // tak pernah hapus data). Open berulang pada bentuk baru = no-op.
359
- if (threadsTableNeedsP24Rebuild(db)) {
360
- assertEmptyTableForRebuild(db, "threads")
361
- db.exec("DROP TABLE IF EXISTS threads")
362
- }
363
- if (projectionsTableNeedsP24Rebuild(db)) {
364
- assertEmptyTableForRebuild(db, "history_projections")
365
- db.exec("DROP TABLE IF EXISTS history_projections")
366
- }
367
- withBusyRetrySync(() => {
368
- db.exec(`
369
- CREATE TABLE IF NOT EXISTS threads (session_id TEXT NOT NULL, thread_id TEXT NOT NULL, parent_thread_id TEXT NULL, fork_event_seq INTEGER NULL, head_seq INTEGER NOT NULL DEFAULT -1, status TEXT NOT NULL DEFAULT 'active', read_only INTEGER NOT NULL DEFAULT 0, created_at INTEGER NOT NULL, PRIMARY KEY(session_id, thread_id), CHECK(head_seq >= -1), CHECK(fork_event_seq IS NULL OR fork_event_seq >= 0));
370
- CREATE INDEX IF NOT EXISTS idx_threads_session ON threads(session_id);
371
- CREATE TABLE IF NOT EXISTS runs (run_id TEXT PRIMARY KEY, session_id TEXT NOT NULL, thread_id TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'CREATED', started_at INTEGER NOT NULL, ended_at INTEGER NULL, last_persisted_seq INTEGER NOT NULL DEFAULT 0, pending_tool_ids TEXT NOT NULL DEFAULT '[]', recovery_status TEXT NULL, takeover_epoch INTEGER NULL, created_at INTEGER NOT NULL, CHECK(last_persisted_seq >= 0));
372
- CREATE INDEX IF NOT EXISTS idx_runs_session ON runs(session_id, started_at);
373
- CREATE INDEX IF NOT EXISTS idx_runs_thread ON runs(thread_id, started_at);
374
- -- P2.6: ≤1 RUNNING per SESSION (partial unique index = DB-enforced,
375
- -- TOCTOU-safe; pelumba kedua gagal constraint, bukan tayang ganda).
376
- CREATE UNIQUE INDEX IF NOT EXISTS udx_runs_single_running ON runs(session_id) WHERE status = 'RUNNING';
377
- CREATE TABLE IF NOT EXISTS history_projections (session_id TEXT NOT NULL, thread_id TEXT NOT NULL, projection_id TEXT NOT NULL, base_seq INTEGER NOT NULL DEFAULT 0, summary_text TEXT NOT NULL DEFAULT '', included_ranges TEXT NOT NULL DEFAULT '[]', built_at INTEGER NOT NULL, anchor_event_id TEXT NULL, PRIMARY KEY(session_id, thread_id, projection_id), CHECK(base_seq >= 0));
378
- CREATE INDEX IF NOT EXISTS idx_projections_thread ON history_projections(session_id, thread_id);
379
- `)
380
- })
381
- // P2.12 — dua tabel milik daemon, DDL di sini karena `open()` SATU-SATUNYA
382
- // pemilik skema (setiap jalur buka DB melewati retry yang sama; DDL terpisah
383
- // di modul lain = dua jalur setup yang bisa berbeda urutan lock-nya).
384
- //
385
- // consumer_offsets: offset terakhir yang DIACK konsumen. TERPISAH dari
386
- // `runs.last_persisted_seq` (watermark penulis), `writer_epoch` (pagar
387
- // mutasi), dan `presentation_events.event_seq` (kepala kanonik) — empat
388
- // angka yang sering tertukar; kontrak melarang menggabungkannya karena
389
- // offset konsumen = "sudah diproses", bukan "sudah ditulis"/"punya siapa".
390
- //
391
- // daemon_approvals: mesin persetujuan durable. `state` dkk. — UI hanya
392
- // MENGUSULKAN keputusan; baris ini adalah otoritasnya.
393
- withBusyRetrySync(() => {
394
- db.exec(`
395
- CREATE TABLE IF NOT EXISTS consumer_offsets (
396
- consumer_id TEXT NOT NULL,
397
- session_id TEXT NOT NULL,
398
- last_acked_seq INTEGER NOT NULL DEFAULT -1,
399
- updated_at INTEGER NOT NULL,
400
- PRIMARY KEY(consumer_id, session_id),
401
- CHECK(last_acked_seq >= -1)
402
- );
403
- CREATE INDEX IF NOT EXISTS idx_consumer_offsets_session ON consumer_offsets(session_id);
404
- CREATE TABLE IF NOT EXISTS daemon_approvals (
405
- approval_id TEXT PRIMARY KEY,
406
- session_id TEXT NOT NULL,
407
- run_id TEXT NULL,
408
- tool TEXT NOT NULL,
409
- summary TEXT NOT NULL DEFAULT '',
410
- state TEXT NOT NULL,
411
- requested_at INTEGER NOT NULL,
412
- expires_at INTEGER NULL,
413
- decided_at INTEGER NULL,
414
- decision TEXT NULL,
415
- incarnation TEXT NOT NULL,
416
- args_hash TEXT NULL,
417
- invocation_id TEXT NULL
418
- );
419
- CREATE INDEX IF NOT EXISTS idx_daemon_approvals_session ON daemon_approvals(session_id, requested_at);
420
- CREATE INDEX IF NOT EXISTS idx_daemon_approvals_state ON daemon_approvals(state);
421
- `)
422
- })
423
- // [Fase 2 / LOOP-INV-08] Migrasi aditif untuk DB lama: kolom pengikat
424
- // approval. `PRAGMA table_info` + `ALTER TABLE` idempoten, tanpa
425
- // user_version (konvensi yang sama dengan migrasi lain di file ini).
426
- // Baris lama mendapat NULL = "tanpa pengikat" dan tetap terbaca; validasi
427
- // pengikatan memperlakukan NULL sebagai tidak cocok bila sisi eksekusi
428
- // membawa hash (fail-closed), bukan sebagai izin.
429
- try {
430
- const approvalCols = db.prepare("PRAGMA table_info(daemon_approvals)").all() as {
431
- name: string
432
- }[]
433
- if (!approvalCols.some((c) => c.name === "args_hash")) {
434
- db.exec("ALTER TABLE daemon_approvals ADD COLUMN args_hash TEXT NULL")
435
- }
436
- if (!approvalCols.some((c) => c.name === "invocation_id")) {
437
- db.exec("ALTER TABLE daemon_approvals ADD COLUMN invocation_id TEXT NULL")
438
- }
439
- } catch (e) {
440
- process.stderr.write(
441
- `[warn] persistence: daemon_approvals migration skipped: ${(e as Error).message}\n`,
442
- )
443
- }
444
- migratedSessionPaths.add(p)
445
- }
446
- return db
447
- } catch (err) {
448
- try {
449
- db.close()
450
- } catch {}
451
- throw err
452
- }
453
- }
454
-
455
- // P2.12 — gerbang terbuka untuk pemilik skema lain (toko konsumen/persetujuan
456
- // daemon) yang butuh handle lengkap: WAL + busy_timeout + DDL yang sama.
457
- // Sengaja diekspos sebagai fungsi, bukan `open` sendiri, agar setiap pemanggil
458
- // tetap melewati satu jalur setup yang sama.
459
- export function openSessionDb(cwd?: string): Database {
460
- return open(cwd)
461
- }
462
-
463
- // P2.12 — sessions.db milik SATU workspace. Beda dari `openSessionDb` di atas:
464
- // tak pernah jatuh ke `~/.minicode` global. Dipakai toko daemon (offset
465
- // konsumen + persetujuan) karena keduanya menyatakan keadaan SATU workspace;
466
- // menjatuhkannya ke DB bersama membuat konsumen workspace lain "melanjutkan"
467
- // dari progres yang bukan miliknya — dan tak ada yang bisa membedakannya.
468
- export function openWorkspaceSessionDb(cwd?: string): Database {
469
- return open(cwd, true)
470
- }
471
-
472
- // P2.2 — penolakan penulis basi. BEDA dari SQLITE_BUSY (masih boleh retry):
473
- // epoch tak cocok = otoritas telah pindah; retry buta hanya menimpa penulis
474
- // baru. Pemanggil wajib fail-closed (diagnostik eksplisit), bukan retry.
475
- export class StaleWriterError extends Error {
476
- readonly code = "REFUSED_STALE_EPOCH"
477
- readonly sessionId: string
478
- readonly expectedEpoch: number
479
- readonly actualEpoch: number
480
- constructor(sessionId: string, expectedEpoch: number, actualEpoch: number) {
481
- super(
482
- `[persist] REFUSED_STALE_EPOCH sid=${sessionId} expected=${expectedEpoch} actual=${actualEpoch} — authority moved; history NOT durable`,
483
- )
484
- this.name = "StaleWriterError"
485
- this.sessionId = sessionId
486
- this.expectedEpoch = expectedEpoch
487
- this.actualEpoch = actualEpoch
488
- }
489
- }
490
-
491
- // P2.2 — baca pagar generasi penulis (0 bila baris belum ada: nilai awal
492
- // deterministik untuk sesi yang belum pernah persist).
493
- export function readWriterEpoch(id: string, cwd?: string): number {
494
- const db = open(cwd)
495
- try {
496
- const row = db.prepare("SELECT writer_epoch AS epoch FROM sessions WHERE id = ?").get(id) as {
497
- epoch: number | null
498
- } | null
499
- return row?.epoch ?? 0
500
- } finally {
501
- db.close()
502
- }
503
- }
504
-
505
- // Verifikasi pagar DI DALAM transaksi pemanggil. Melempar StaleWriterError
506
- // (rollback oleh txn) bila: baris tak ada padahal ekspektasi > 0 (dunia
507
- // bergerak: sesi dihapus/dibuat ulang), atau epoch tak cocok.
508
- function assertWriterEpochInTxn(db: Database, id: string, expectedEpoch: number): void {
509
- const row = db.prepare("SELECT writer_epoch AS epoch FROM sessions WHERE id = ?").get(id) as {
510
- epoch: number | null
511
- } | null
512
- const actual = row?.epoch ?? 0
513
- if (row !== null && actual !== expectedEpoch) {
514
- throw new StaleWriterError(id, expectedEpoch, actual)
515
- }
516
- if (row === null && expectedEpoch !== 0) {
517
- throw new StaleWriterError(id, expectedEpoch, actual)
518
- }
519
- }
520
- // array ribuan angka — cukup placeholder agar DB tidak menggembung.
521
- // Bentuk lama P2.3 terdeteksi dari PK: [thread_id] saja (threads) atau
522
- // absennya kolom session_id (history_projections). Bentuk baru / tak-ada
523
- // tabel → false (CREATE IF NOT EXISTS cukup).
524
- function threadsTableNeedsP24Rebuild(db: Database): boolean {
525
- try {
526
- const cols = db.prepare("PRAGMA table_info(threads)").all() as { name: string; pk: number }[]
527
- if (cols.length === 0) return false
528
- const pk = cols
529
- .filter((c) => c.pk > 0)
530
- .sort((a, b) => a.pk - b.pk)
531
- .map((c) => c.name)
532
- return !(pk.length === 2 && pk[0] === "session_id" && pk[1] === "thread_id")
533
- } catch {
534
- return false
535
- }
536
- }
537
-
538
- function projectionsTableNeedsP24Rebuild(db: Database): boolean {
539
- try {
540
- const cols = db.prepare("PRAGMA table_info(history_projections)").all() as { name: string }[]
541
- if (cols.length === 0) return false
542
- return !cols.some((c) => c.name === "session_id")
543
- } catch {
544
- return false
545
- }
546
- }
547
-
548
- // P2.4 — penolak rebuild destruktif. Dipakai HANYA untuk tabel kerangka
549
- // P2.3 yang dijamin kosong (netralitas runtime + guard): bila ada baris,
550
- // rebuild DITOLAK loud (tak pernah hapus data diam-diam). Tabel tak-ada =
551
- // aman (belum pernah dibuat).
552
- function assertEmptyTableForRebuild(db: Database, table: string): void {
553
- let exists = false
554
- try {
555
- const row = db
556
- .prepare("SELECT 1 AS ok FROM sqlite_master WHERE type = 'table' AND name = ?")
557
- .get(table) as { ok: number } | null
558
- exists = row !== null
559
- } catch {
560
- return
561
- }
562
- if (!exists) return
563
- const n = (db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get() as { n: number }).n
564
- if (n > 0) {
565
- throw new Error(
566
- `[persistence] refusing to rebuild non-empty table ${table} (${n} rows) — migrate, never destroy`,
567
- )
568
- }
13
+ import {
14
+ advanceRunCursor,
15
+ advanceRunCursorInTxn,
16
+ allocateRunId,
17
+ assessRunRecoveryStatus,
18
+ completeRun,
19
+ createRun,
20
+ failRun,
21
+ getActiveRun,
22
+ getRun,
23
+ interruptRun,
24
+ isRunId,
25
+ listSessionRuns,
26
+ RUN_TERMINAL,
27
+ RunCursorError,
28
+ RunPendingError,
29
+ type RunRow,
30
+ RunRunningExistsError,
31
+ type RunStatus,
32
+ RunStatusError,
33
+ RunTerminalConflictError,
34
+ setRunPendingTools,
35
+ tombstoneDeadRuns,
36
+ transitionRun,
37
+ } from "./db/runs.ts"
38
+ import {
39
+ assertWriterEpochInTxn,
40
+ dbPath,
41
+ openSessionHandle as open,
42
+ openSessionDb,
43
+ openWorkspaceSessionDb,
44
+ readWriterEpoch,
45
+ StaleWriterError,
46
+ sessionRowExistsInTxn,
47
+ withBusyRetrySync,
48
+ } from "./db/schema.ts"
49
+
50
+ export type { RunRow, RunStatus }
51
+ export {
52
+ advanceRunCursor,
53
+ allocateRunId,
54
+ assessRunRecoveryStatus,
55
+ completeRun,
56
+ createRun,
57
+ failRun,
58
+ getActiveRun,
59
+ getRun,
60
+ interruptRun,
61
+ isRunId,
62
+ listSessionRuns,
63
+ openSessionDb,
64
+ openWorkspaceSessionDb,
65
+ RunCursorError,
66
+ RunPendingError,
67
+ RunRunningExistsError,
68
+ RunStatusError,
69
+ RunTerminalConflictError,
70
+ readWriterEpoch,
71
+ StaleWriterError,
72
+ setRunPendingTools,
73
+ tombstoneDeadRuns,
74
+ transitionRun,
75
+ withBusyRetrySync,
569
76
  }
570
77
 
571
78
  // JSON-safe serialization: konten binary (Uint8Array) jangan di-stringify jadi
@@ -1132,7 +639,7 @@ export async function saveSession(
1132
639
  opts?: {
1133
640
  expectedEpoch?: number
1134
641
  runId?: string
1135
- workMode?: "DISCUSS" | "PLAN" | "EXECUTE"
642
+ workMode?: "DISCUSS" | "EXECUTE"
1136
643
  },
1137
644
  ) {
1138
645
  const db = open(cwd)
@@ -1374,6 +881,7 @@ export function purgeExpired(db: Database, now = Date.now()): number {
1374
881
 
1375
882
  if (expiring.length > 0) {
1376
883
  const { TaskStore } = require("../task/store.ts") as typeof import("../task/store.ts")
884
+ const { deleteTodoFilesSync } = require("../tools/todo.ts") as typeof import("../tools/todo.ts")
1377
885
  const fallbackCwd = sessionCwdOf(db, expiring)
1378
886
  const byCwd = new Map<string | undefined, string[]>()
1379
887
  for (const row of expiring) {
@@ -1384,10 +892,12 @@ export function purgeExpired(db: Database, now = Date.now()): number {
1384
892
  }
1385
893
  for (const [cwd, ids] of byCwd) {
1386
894
  const tasks = new TaskStore(cwd)
895
+ const resolvedCwd = cwd ?? process.cwd()
1387
896
  for (const sid of ids) {
1388
- // 1. invalidate in-flight executions, 2. remove task rows.
897
+ // 1. invalidate in-flight executions, 2. remove task rows, 3. remove derived todo/plan files.
1389
898
  tasks.bumpSessionIncarnation(sid)
1390
899
  tasks.deleteSessionTasks(sid)
900
+ deleteTodoFilesSync(sid, resolvedCwd)
1391
901
  }
1392
902
  }
1393
903
  }
@@ -1489,15 +999,13 @@ function decodeMessageRows(rows: StoredMessageRow[]): unknown[] {
1489
999
  })
1490
1000
  }
1491
1001
 
1492
- function parseStoredWorkMode(raw: unknown): "DISCUSS" | "PLAN" | "EXECUTE" | undefined {
1493
- if (raw === "DISCUSS" || raw === "PLAN" || raw === "EXECUTE") return raw
1002
+ function parseStoredWorkMode(raw: unknown): "DISCUSS" | "EXECUTE" | undefined {
1003
+ if (raw === "DISCUSS" || raw === "PLAN") return "DISCUSS"
1004
+ if (raw === "EXECUTE") return "EXECUTE"
1494
1005
  return undefined
1495
1006
  }
1496
1007
 
1497
- export function loadSessionWorkMode(
1498
- id: string,
1499
- cwd?: string,
1500
- ): "DISCUSS" | "PLAN" | "EXECUTE" | undefined {
1008
+ export function loadSessionWorkMode(id: string, cwd?: string): "DISCUSS" | "EXECUTE" | undefined {
1501
1009
  const db = open(cwd)
1502
1010
  try {
1503
1011
  const row = db.prepare("SELECT work_mode FROM sessions WHERE id = ?").get(id) as {
@@ -1511,7 +1019,7 @@ export function loadSessionWorkMode(
1511
1019
 
1512
1020
  export function saveSessionWorkMode(
1513
1021
  id: string,
1514
- workMode: "DISCUSS" | "PLAN" | "EXECUTE",
1022
+ workMode: "DISCUSS" | "EXECUTE",
1515
1023
  cwd?: string,
1516
1024
  opts?: { expectedEpoch?: number },
1517
1025
  ): void {
@@ -2865,438 +2373,6 @@ export function appendHistoryEvent(
2865
2373
  // persistensi, bukan token/usaha). ≤1 RUNNING per SESSION ditegakkan
2866
2374
  // partial-unique-index (ras-aman, tanpa TOCTOU). Semua mutasi berpagar epoch.
2867
2375
 
2868
- export type RunStatus = "CREATED" | "RUNNING" | "COMPLETED" | "INTERRUPTED" | "FAILED"
2869
-
2870
- const RUN_TERMINAL: ReadonlySet<string> = new Set(["COMPLETED", "INTERRUPTED", "FAILED"])
2871
-
2872
- export interface RunRow {
2873
- run_id: string
2874
- session_id: string
2875
- thread_id: string
2876
- status: RunStatus
2877
- started_at: number
2878
- ended_at: number | null
2879
- last_persisted_seq: number
2880
- pending_tool_ids: string
2881
- recovery_status: string | null
2882
- takeover_epoch: number | null
2883
- created_at: number
2884
- }
2885
-
2886
- const RUN_ID_RE = /^run_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/
2887
-
2888
- export function isRunId(value: unknown): value is string {
2889
- return typeof value === "string" && RUN_ID_RE.test(value)
2890
- }
2891
-
2892
- // SATU-SATUNYA allocator RunId produksi (CSPRNG; domain sesi, berbeda dari
2893
- // exec_/dsp_/attempt — lihat keputusan §6 laporan: tak ada reuse).
2894
- export function allocateRunId(): string {
2895
- return `run_${randomUUID()}`
2896
- }
2897
-
2898
- export class RunStatusError extends Error {
2899
- readonly code = "RUN_INVALID_TRANSITION"
2900
- constructor(runId: string, from: string, to: string) {
2901
- super(`[run] RUN_INVALID_TRANSITION ${runId}: ${from} → ${to} refused`)
2902
- this.name = "RunStatusError"
2903
- }
2904
- }
2905
-
2906
- export class RunTerminalConflictError extends Error {
2907
- readonly code = "RUN_TERMINAL_CONFLICT"
2908
- constructor(runId: string, from: string, to: string) {
2909
- super(
2910
- `[run] RUN_TERMINAL_CONFLICT ${runId}: already terminal ${from}, refusing conflicting ${to} (first terminal wins)`,
2911
- )
2912
- this.name = "RunTerminalConflictError"
2913
- }
2914
- }
2915
-
2916
- export class RunRunningExistsError extends Error {
2917
- readonly code = "RUNNING_EXISTS"
2918
- constructor(sessionId: string) {
2919
- super(`[run] RUNNING_EXISTS ${sessionId}: a RUNNING run already holds this session`)
2920
- this.name = "RunRunningExistsError"
2921
- }
2922
- }
2923
-
2924
- export class RunCursorError extends Error {
2925
- readonly code: "RUN_CURSOR_BACKWARD" | "RUN_CURSOR_BEYOND_HEAD" | "RUN_CURSOR_FOREIGN"
2926
- constructor(code: RunCursorError["code"], runId: string, detail: string) {
2927
- super(`[run] ${code} ${runId}: ${detail}`)
2928
- this.name = "RunCursorError"
2929
- this.code = code
2930
- }
2931
- }
2932
-
2933
- export class RunPendingError extends Error {
2934
- readonly code = "RUN_PENDING_MALFORMED"
2935
- constructor(detail: string) {
2936
- super(`[run] RUN_PENDING_MALFORMED: ${detail}`)
2937
- this.name = "RunPendingError"
2938
- }
2939
- }
2940
-
2941
- function rowToRun(row: RunRow): RunRow {
2942
- return { ...row }
2943
- }
2944
-
2945
- const RUN_COLUMNS =
2946
- "run_id, session_id, thread_id, status, started_at, ended_at, last_persisted_seq, pending_tool_ids, recovery_status, takeover_epoch, created_at"
2947
-
2948
- export function getRun(runId: string, cwd?: string): RunRow | null {
2949
- const db = open(cwd)
2950
- try {
2951
- const row = db
2952
- .prepare(`SELECT ${RUN_COLUMNS} FROM runs WHERE run_id = ?`)
2953
- .get(runId) as RunRow | null
2954
- return row ? rowToRun(row) : null
2955
- } finally {
2956
- db.close()
2957
- }
2958
- }
2959
-
2960
- export function listSessionRuns(sessionId: string, cwd?: string): RunRow[] {
2961
- const db = open(cwd)
2962
- try {
2963
- return (
2964
- db
2965
- .prepare(`SELECT ${RUN_COLUMNS} FROM runs WHERE session_id = ? ORDER BY started_at`)
2966
- .all(sessionId) as RunRow[]
2967
- ).map(rowToRun)
2968
- } finally {
2969
- db.close()
2970
- }
2971
- }
2972
-
2973
- // RUNNING aktif sesi ini (0-atau-1 menurut partial index; defensif LIMIT 1).
2974
- export function getActiveRun(sessionId: string, cwd?: string): RunRow | null {
2975
- const db = open(cwd)
2976
- try {
2977
- const row = db
2978
- .prepare(
2979
- `SELECT ${RUN_COLUMNS} FROM runs WHERE session_id = ? AND status = 'RUNNING' LIMIT 1`,
2980
- )
2981
- .get(sessionId) as RunRow | null
2982
- return row ? rowToRun(row) : null
2983
- } finally {
2984
- db.close()
2985
- }
2986
- }
2987
-
2988
- // Penilaian pulih read-only (tak pernah memutasi): ketidakpastian TERSIMPAN
2989
- // (recovery_status UNKNOWN) atau RUNNING tanpa holder hidup = UNKNOWN;
2990
- // sisanya NONE. Persistensi resolusi milik fase mendatang; P2.6 hanya
2991
- // menombak yang mati pasti + menilainya jujur.
2992
- export function assessRunRecoveryStatus(run: RunRow): "NONE" | "UNKNOWN" {
2993
- if (run.recovery_status === "UNKNOWN") return "UNKNOWN"
2994
- if (run.status === "RUNNING") return "UNKNOWN"
2995
- return "NONE"
2996
- }
2997
-
2998
- function validatePendingToolIds(value: unknown): string {
2999
- if (!Array.isArray(value)) throw new RunPendingError("pending_tool_ids must be an array")
3000
- if (value.length > 256) throw new RunPendingError("pending_tool_ids exceeds 256 entries")
3001
- for (const entry of value) {
3002
- if (typeof entry !== "string" || entry.length === 0 || entry.length > 512) {
3003
- throw new RunPendingError("pending_tool_ids entries must be non-empty strings ≤512 chars")
3004
- }
3005
- }
3006
- return JSON.stringify(value)
3007
- }
3008
-
3009
- // Satu jalur create produksi: validasi kepemilikan (thread milik sesi) +
3010
- // pagar epoch + baris CREATED (kursor = head saat ini, netral) + epoch
3011
- // takeover tercatat. Status awal SELALU CREATED; pemanggil yang
3012
- // mempromosikan ke RUNNING via transitionRun (dua langkah eksplisit).
3013
- export function createRun(
3014
- sessionId: string,
3015
- threadId: string,
3016
- cwd?: string,
3017
- opts?: { runId?: string; pendingToolIds?: unknown; expectedEpoch?: number },
3018
- ): RunRow {
3019
- const db = open(cwd)
3020
- try {
3021
- return db.transaction(() => {
3022
- if (opts?.expectedEpoch !== undefined)
3023
- assertWriterEpochInTxn(db, sessionId, opts.expectedEpoch)
3024
- if (!sessionRowExistsInTxn(db, sessionId)) throw new Error(`session not found: ${sessionId}`)
3025
- const thread = db
3026
- .prepare("SELECT thread_id FROM threads WHERE session_id = ? AND thread_id = ?")
3027
- .get(sessionId, threadId) as { thread_id: string } | null
3028
- if (!thread) throw new Error(`thread not found: ${sessionId}/${threadId}`)
3029
- const runId = opts?.runId ?? allocateRunId()
3030
- if (!isRunId(runId)) throw new Error(`invalid run id: ${opts?.runId}`)
3031
- const pending =
3032
- opts?.pendingToolIds !== undefined ? validatePendingToolIds(opts.pendingToolIds) : "[]"
3033
- const now = Date.now()
3034
- const headRow = db
3035
- .prepare("SELECT MAX(seq) AS m FROM messages WHERE session_id = ? AND thread_id = ?")
3036
- .get(sessionId, threadId) as { m: number | null } | null
3037
- // Head thread kosong = -1, tapi kursor run punya CHECK >= 0 dan harus
3038
- // menunjuk posisi histori yang benar-benar durable: kursor awal 0 pada
3039
- // thread kosong berarti "belum ada event milik run ini" (bukan klaim
3040
- // bahwa seq 0 milik run ini — kepemilikan dicek saat advance).
3041
- const head = Math.max(headRow?.m ?? -1, 0)
3042
- const epochRow = db
3043
- .prepare("SELECT writer_epoch AS epoch FROM sessions WHERE id = ?")
3044
- .get(sessionId) as {
3045
- epoch: number
3046
- }
3047
- db.prepare(
3048
- "INSERT INTO runs (run_id, session_id, thread_id, status, started_at, ended_at, last_persisted_seq, pending_tool_ids, recovery_status, takeover_epoch, created_at) VALUES (?, ?, ?, 'CREATED', ?, NULL, ?, ?, 'NONE', ?, ?)",
3049
- ).run(runId, sessionId, threadId, now, head, pending, epochRow.epoch, now)
3050
- return rowToRun({
3051
- run_id: runId,
3052
- session_id: sessionId,
3053
- thread_id: threadId,
3054
- status: "CREATED",
3055
- started_at: now,
3056
- ended_at: null,
3057
- last_persisted_seq: head,
3058
- pending_tool_ids: pending,
3059
- recovery_status: "NONE",
3060
- takeover_epoch: epochRow.epoch,
3061
- created_at: now,
3062
- })
3063
- })()
3064
- } finally {
3065
- db.close()
3066
- }
3067
- }
3068
-
3069
- function sessionRowExistsInTxn(db: Database, sessionId: string): boolean {
3070
- const row = db.prepare("SELECT 1 AS ok FROM sessions WHERE id = ?").get(sessionId) as {
3071
- ok: number
3072
- } | null
3073
- return row !== null
3074
- }
3075
-
3076
- const RUN_EDGES: Record<RunStatus, readonly RunStatus[]> = {
3077
- CREATED: ["RUNNING", "COMPLETED", "INTERRUPTED", "FAILED"],
3078
- RUNNING: ["COMPLETED", "INTERRUPTED", "FAILED"],
3079
- COMPLETED: ["COMPLETED"],
3080
- INTERRUPTED: ["INTERRUPTED"],
3081
- FAILED: ["FAILED"],
3082
- }
3083
-
3084
- // Transisi status fenced. Terminal→sama = idempoten (ended_at pertama menang);
3085
- // terminal→beda = konflik (first terminal wins, bukan last-writer-wins).
3086
- // RUNNING kedua konkuren = constraint partial-index → RUNNING_EXISTS terstruktur.
3087
- export function transitionRun(
3088
- runId: string,
3089
- to: RunStatus,
3090
- cwd?: string,
3091
- opts?: { expectedEpoch?: number; recoveryStatus?: string },
3092
- ): RunRow {
3093
- const db = open(cwd)
3094
- try {
3095
- return db.transaction(() => {
3096
- const row = db
3097
- .prepare(`SELECT ${RUN_COLUMNS} FROM runs WHERE run_id = ?`)
3098
- .get(runId) as RunRow | null
3099
- if (!row) throw new Error(`run not found: ${runId}`)
3100
- if (opts?.expectedEpoch !== undefined)
3101
- assertWriterEpochInTxn(db, row.session_id, opts.expectedEpoch)
3102
- // Terminal: dua kelas penolakan dibedakan agar diagnosis jujur —
3103
- // terminal→terminal lain = konflik first-wins; terminal→non-terminal
3104
- // = tepi ilegal (bukan "konflik" — tak ada klaim terminal kedua).
3105
- if (RUN_TERMINAL.has(row.status)) {
3106
- if (row.status === to) return rowToRun(row)
3107
- if (RUN_TERMINAL.has(to)) throw new RunTerminalConflictError(runId, row.status, to)
3108
- throw new RunStatusError(runId, row.status, to)
3109
- }
3110
- if (!RUN_EDGES[row.status].includes(to)) throw new RunStatusError(runId, row.status, to)
3111
- const now = Date.now()
3112
- const terminal = RUN_TERMINAL.has(to)
3113
- const recovery = to === "INTERRUPTED" ? (opts?.recoveryStatus ?? "NONE") : "NONE"
3114
- try {
3115
- db.prepare(
3116
- "UPDATE runs SET status = ?, ended_at = ?, recovery_status = ? WHERE run_id = ?",
3117
- ).run(to, terminal ? now : null, recovery, runId)
3118
- } catch (e) {
3119
- if (isRunningUniquenessViolation(e)) throw new RunRunningExistsError(row.session_id)
3120
- throw e
3121
- }
3122
- return rowToRun({
3123
- ...row,
3124
- status: to,
3125
- ended_at: terminal ? now : row.ended_at,
3126
- recovery_status: recovery,
3127
- })
3128
- })()
3129
- } finally {
3130
- db.close()
3131
- }
3132
- }
3133
-
3134
- function isRunningUniquenessViolation(e: unknown): boolean {
3135
- const msg = String((e as Error)?.message ?? e)
3136
- return msg.includes("UNIQUE constraint failed") && msg.includes("runs")
3137
- }
3138
-
3139
- export function completeRun(
3140
- runId: string,
3141
- cwd?: string,
3142
- opts?: { expectedEpoch?: number },
3143
- ): RunRow {
3144
- return transitionRun(runId, "COMPLETED", cwd, opts)
3145
- }
3146
-
3147
- export function failRun(runId: string, cwd?: string, opts?: { expectedEpoch?: number }): RunRow {
3148
- return transitionRun(runId, "FAILED", cwd, opts)
3149
- }
3150
-
3151
- export function interruptRun(
3152
- runId: string,
3153
- cwd?: string,
3154
- opts?: { expectedEpoch?: number; recoveryStatus?: string },
3155
- ): RunRow {
3156
- return transitionRun(runId, "INTERRUPTED", cwd, opts)
3157
- }
3158
-
3159
- // Kursor eksplisit: monoton (CAS pada nilai terbaca — tanpa lost-update),
3160
- // dalam-head, milik-run ini (NULL warisan boleh; run lain ditolak).
3161
- // Versi in-txn dipakai appendHistoryEvent supaya event+kursor satu commit.
3162
- function advanceRunCursorInTxn(
3163
- db: Database,
3164
- runId: string,
3165
- seq: number,
3166
- expectSessionId: string | undefined,
3167
- opts?: { expectedEventId?: string },
3168
- ): RunRow {
3169
- const row = db
3170
- .prepare(`SELECT ${RUN_COLUMNS} FROM runs WHERE run_id = ?`)
3171
- .get(runId) as RunRow | null
3172
- if (!row) throw new Error(`run not found: ${runId}`)
3173
- if (expectSessionId !== undefined && row.session_id !== expectSessionId)
3174
- throw new Error(`run ${runId} does not belong to session ${expectSessionId}`)
3175
- if (RUN_TERMINAL.has(row.status))
3176
- throw new RunStatusError(runId, row.status, `${row.status}+cursor`)
3177
- if (!Number.isInteger(seq) || seq < 0)
3178
- throw new RunCursorError("RUN_CURSOR_BEYOND_HEAD", runId, `invalid seq ${seq}`)
3179
- const target = db
3180
- .prepare(
3181
- "SELECT seq, run_id, event_id FROM messages WHERE session_id = ? AND thread_id = ? AND seq = ?",
3182
- )
3183
- .get(row.session_id, row.thread_id, seq) as {
3184
- seq: number
3185
- run_id: string | null
3186
- event_id: string | null
3187
- } | null
3188
- if (!target)
3189
- throw new RunCursorError("RUN_CURSOR_BEYOND_HEAD", runId, `no durable event at seq ${seq}`)
3190
- if (target.run_id !== null && target.run_id !== runId) {
3191
- throw new RunCursorError(
3192
- "RUN_CURSOR_FOREIGN",
3193
- runId,
3194
- `seq ${seq} belongs to run ${target.run_id}`,
3195
- )
3196
- }
3197
- if (opts?.expectedEventId !== undefined && target.event_id !== opts.expectedEventId) {
3198
- throw new RunCursorError("RUN_CURSOR_FOREIGN", runId, `seq ${seq} event mismatch`)
3199
- }
3200
- if (seq < row.last_persisted_seq) {
3201
- throw new RunCursorError(
3202
- "RUN_CURSOR_BACKWARD",
3203
- runId,
3204
- `${row.last_persisted_seq} → ${seq} refused (no rewind in P2.6)`,
3205
- )
3206
- }
3207
- if (seq === row.last_persisted_seq) return rowToRun(row)
3208
- const upd = db
3209
- .prepare("UPDATE runs SET last_persisted_seq = ? WHERE run_id = ? AND last_persisted_seq = ?")
3210
- .run(seq, runId, row.last_persisted_seq)
3211
- if (upd.changes === 0) {
3212
- const cur = db.prepare("SELECT last_persisted_seq FROM runs WHERE run_id = ?").get(runId) as {
3213
- last_persisted_seq: number
3214
- }
3215
- throw new RunCursorError(
3216
- "RUN_CURSOR_BACKWARD",
3217
- runId,
3218
- `concurrent advance observed (now ${cur.last_persisted_seq})`,
3219
- )
3220
- }
3221
- return rowToRun({ ...row, last_persisted_seq: seq })
3222
- }
3223
-
3224
- export function advanceRunCursor(
3225
- runId: string,
3226
- seq: number,
3227
- cwd?: string,
3228
- opts?: { expectedEpoch?: number; expectedEventId?: string },
3229
- ): RunRow {
3230
- const db = open(cwd)
3231
- try {
3232
- return db.transaction(() => {
3233
- if (opts?.expectedEpoch !== undefined) {
3234
- const owner = db.prepare("SELECT session_id FROM runs WHERE run_id = ?").get(runId) as {
3235
- session_id: string
3236
- } | null
3237
- if (!owner) throw new Error(`run not found: ${runId}`)
3238
- assertWriterEpochInTxn(db, owner.session_id, opts.expectedEpoch)
3239
- }
3240
- return advanceRunCursorInTxn(db, runId, seq, undefined, opts)
3241
- })()
3242
- } finally {
3243
- db.close()
3244
- }
3245
- }
3246
-
3247
- // Metadata pending_tool_ids (dorman P2.6): round-trip tervalidasi, fenced.
3248
- // BUKAN bukti eksekusi — tak ada semantik tool di sini.
3249
- export function setRunPendingTools(
3250
- runId: string,
3251
- pendingToolIds: unknown,
3252
- cwd?: string,
3253
- opts?: { expectedEpoch?: number },
3254
- ): RunRow {
3255
- const db = open(cwd)
3256
- try {
3257
- return db.transaction(() => {
3258
- const row = db
3259
- .prepare(`SELECT ${RUN_COLUMNS} FROM runs WHERE run_id = ?`)
3260
- .get(runId) as RunRow | null
3261
- if (!row) throw new Error(`run not found: ${runId}`)
3262
- if (opts?.expectedEpoch !== undefined)
3263
- assertWriterEpochInTxn(db, row.session_id, opts.expectedEpoch)
3264
- const pending = validatePendingToolIds(pendingToolIds)
3265
- db.prepare("UPDATE runs SET pending_tool_ids = ? WHERE run_id = ?").run(pending, runId)
3266
- return rowToRun({ ...row, pending_tool_ids: pending })
3267
- })()
3268
- } finally {
3269
- db.close()
3270
- }
3271
- }
3272
-
3273
- // Tombstone crash-residue: SEMUA RUNNING sesi ini (tanpa holder hidup —
3274
- // admission membuktikannya) menjadi INTERRUPTED + recovery UNKNOWN dengan
3275
- // ended_at NULL (kematian tak terobservasi). Satu statement (atomik, tanpa
3276
- // TOCTOU). BUKAN auto-continue/replay: resolusi milik fase mendatang.
3277
- // Fenced; idempoten (pemanggilan kedua nihil).
3278
- export function tombstoneDeadRuns(
3279
- sessionId: string,
3280
- cwd?: string,
3281
- opts?: { expectedEpoch?: number },
3282
- ): number {
3283
- const db = open(cwd)
3284
- try {
3285
- return db.transaction(() => {
3286
- if (opts?.expectedEpoch !== undefined)
3287
- assertWriterEpochInTxn(db, sessionId, opts.expectedEpoch)
3288
- const res = db
3289
- .prepare(
3290
- "UPDATE runs SET status = 'INTERRUPTED', recovery_status = 'UNKNOWN' WHERE session_id = ? AND status = 'RUNNING'",
3291
- )
3292
- .run(sessionId)
3293
- return res.changes
3294
- })()
3295
- } finally {
3296
- db.close()
3297
- }
3298
- }
3299
-
3300
2376
  // ── P2.7 — Projection foundation ────────────────────────────────────────────
3301
2377
  // Proyeksi = representasi TURUNAN dari messages (read-only build, rebuildable,
3302
2378
  // tak pernah otoritatif). Satu-satunya jenis P2.7: "summary" (ringkasan prefix).