minicode-ai 0.9.28 → 0.10.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 (48) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/cli/args.ts +1 -0
  3. package/cli/commands.ts +219 -103
  4. package/cli/index.ts +8 -6
  5. package/cli/model-manager.ts +2 -7
  6. package/cli/provider-manager.ts +13 -13
  7. package/cli/setup.ts +10 -1
  8. package/cli/tui.ts +506 -0
  9. package/cli/wizard.ts +2 -1
  10. package/docs/ARCHITECTURE.html +41 -22
  11. package/docs/README.md +1 -0
  12. package/package.json +3 -3
  13. package/src/app/rag-layer.ts +7 -2
  14. package/src/config.ts +30 -1
  15. package/src/policy/bash-guard.ts +64 -8
  16. package/src/policy/update-check.ts +4 -1
  17. package/src/tools/bash.ts +8 -0
  18. package/src/tools/task.ts +6 -1
  19. package/src/tools/web_fetch.ts +11 -2
  20. package/src/tools/web_search.ts +4 -1
  21. package/src/ui/approval/prompt.ts +84 -18
  22. package/src/ui/assistant/simple.ts +55 -22
  23. package/src/ui/assistant/turn-status.ts +16 -7
  24. package/src/ui/footer.ts +14 -12
  25. package/src/ui/i18n/en.ts +225 -0
  26. package/src/ui/i18n/id.ts +227 -0
  27. package/src/ui/i18n/locale.ts +66 -0
  28. package/src/ui/input/input.ts +138 -77
  29. package/src/ui/input/prompt-engine.ts +97 -4
  30. package/src/ui/render/collapse.ts +8 -1
  31. package/src/ui/render/errors.ts +75 -50
  32. package/src/ui/render/format.ts +15 -5
  33. package/src/ui/render/highlight.ts +5 -2
  34. package/src/ui/render/table.ts +7 -4
  35. package/src/ui/render/theme.ts +8 -3
  36. package/src/ui/render/width.ts +17 -9
  37. package/src/ui/runtime/screen.ts +197 -0
  38. package/src/ui/screens/dialog.ts +174 -0
  39. package/src/ui/screens/form.ts +459 -0
  40. package/src/ui/screens/model-manager.ts +274 -127
  41. package/src/ui/screens/picker.ts +229 -98
  42. package/src/ui/screens/provider-manager.ts +371 -164
  43. package/src/ui/screens/wizard.ts +149 -102
  44. package/src/ui/tui/app.ts +745 -0
  45. package/src/ui/tui/transcript.ts +271 -0
  46. package/cli/repl.ts +0 -740
  47. package/src/ui/runtime/chrome.ts +0 -369
  48. package/src/ui/screens/overlay.ts +0 -61
@@ -1,369 +0,0 @@
1
- // Footer lengket (sticky) — chrome terminal REPL.
2
- //
3
- // Mengunci 2 baris dasar terminal untuk footer (blank + status, tanpa garis)
4
- // lewat scroll-region DECSTBM (`\x1b[1;{top}r`): output turn hanya di area
5
- // atas, footer tidak pernah ikut scroll. Sama dengan kontrak transient
6
- // statusline.ts: TIDAK pernah melempar, fail-closed, self-disable bila runtime
7
- // bermasalah, dan selalui reset region pada detach/exit agar terminal tidak
8
- // ditinggalkan rusak.
9
- //
10
- // Gaya `MINICODE_FOOTER`:
11
- // off → tanpa footer sama sekali (dan pipa selalu none: 0 byte)
12
- // print → footer dicetak sebagai baris scrollback biasa (tidak lengket)
13
- // sticky → paksa lengket (bila terminal mampu; selain itu jatuh ke print)
14
- // auto → lengket bila mampu, print bila tidak (DEFAULT)
15
- //
16
- // Mengapa DECSTBM dan bukan alternate screen: alternaate screen menyembunyikan
17
- // seluruh scrollback pengguna — melanggar kontrak shell-native. Scroll-region
18
- // justru TIDAK memindahkan scrollback: region adalah jendela scroll TAMBAHAN,
19
- // konten lama tetap utuh di atasnya.
20
- import { type FooterStatus, renderFooter } from "../footer.ts"
21
-
22
- export type FooterMode = "off" | "print" | "sticky" | "auto"
23
-
24
- export interface FooterChromeOptions {
25
- /** Status yang dirender tiap present — di-resolve pemanggil (mode live, cwd). */
26
- status: () => FooterStatus
27
- /** Non-interactive (exec/pipe): pemanggil mematikan footer total. */
28
- enabled?: boolean
29
- }
30
-
31
- export interface FooterChrome {
32
- readonly mode: "sticky" | "print" | "none"
33
- /** Baris dasar yang wajib disisakan editor/prompt (sticky=2, lainnya 0). */
34
- reserveRows(): number
35
- /**
36
- * Panggil tepat sebelum prompt idle: sticky → pastikan region + repaint
37
- * footer + posisikan kursor di baris input; print → cetak footer sebagai
38
- * baris scrollback. Idempotent; tidak pernah melempar.
39
- */
40
- present(): void
41
- /**
42
- * Repaint footer DI TEMPAT tanpa memindahkan kursor — dipakai perubahan
43
- * status saat prompt aktif (mis. Shift+Tab ganti mode). Sticky: repaint 2
44
- * baris dasar; print/none: no-op (footer berikutnya dicetak di idle).
45
- */
46
- refresh(): void
47
- /**
48
- * Tandai turn berjalan/selesai. Busy → spark di footer berdenyut (timer
49
- * repaint ~150ms, fail-safe: tak pernah melempar, mati sendiri bila runtime
50
- * rewel); idle → spark redup statis. Dipanggil dari controller turn, jadi
51
- * abort (Ctrl+C/Esc) otomatis kembali redup lewat finally.
52
- */
53
- setBusy(busy: boolean): void
54
- /**
55
- * Reset region + restore scrollback, lalu cetak footer sekali sebagai baris
56
- * normal. Panggil di SEMUA jalur keluar (close/exit/SIGINT/on("exit")).
57
- */
58
- detach(): void
59
- }
60
-
61
- // ── State pemilih mode (module-level agar input.ts bisa baca jatah baris) ──
62
-
63
- let activeReserve = 0
64
-
65
- /** Jatah baris dasar yang sedang dipakai chrome (0 bila tidak lengket). */
66
- export function footerReserveRows(): number {
67
- return activeReserve
68
- }
69
-
70
- const RESET_REGION = "\x1b[r"
71
- const CLEAR = "\x1b[2K"
72
- const SYNC_START = "\x1b[?2026h"
73
- const SYNC_END = "\x1b[?2026l"
74
- // DECSC/DECRC (save/restore cursor). Dipakai agar penulisan direct-address
75
- // footer + DECSTBM tidak pernah menggeser posisi ketik: sebagian terminal
76
- // (emulasi VT100) memindahkan kursor ke home saat scroll-region di-set, dan
77
- // `refresh()` dipanggil saat prompt aktif — tanpa save/restore, repaint
78
- // berikutnya menimpa baris footer.
79
- const SAVE_CURSOR = "\x1b7"
80
- const RESTORE_CURSOR = "\x1b8"
81
-
82
- function isWinLegacy(): boolean {
83
- return (
84
- process.platform === "win32" &&
85
- !(
86
- process.env.WT_SESSION ||
87
- process.env.TERM_PROGRAM ||
88
- process.env.ANSICON ||
89
- process.env.ConEmuANSI
90
- )
91
- )
92
- }
93
-
94
- /** Sticky butuh VT DECSTBM + baris cukup (2 dasar + ≥9 area kerja). */
95
- function capable(rows: number): boolean {
96
- if (isWinLegacy()) return false
97
- if (rows < 10) return false
98
- return true
99
- }
100
-
101
- /** Posisi 1-indexed dari 2 baris dasar (blank + status, tanpa garis). */
102
- const FOOTER_ROWS = 2
103
-
104
- export function createFooterChrome(opts: FooterChromeOptions): FooterChrome {
105
- // Pipa/redirect: nol byte — kontrak deterministik machine output.
106
- if (!opts.enabled || !process.stdout.isTTY) return makeNone()
107
- const env = (process.env.MINICODE_FOOTER ?? "auto") as string
108
- const want: FooterMode = env === "off" || env === "print" || env === "sticky" ? env : "auto"
109
- const rows = () => process.stdout.rows || 24
110
-
111
- const sticky = want === "sticky" || want === "auto"
112
- const useSticky = sticky && capable(rows())
113
- // sticky yang diminta tapi terminal tak mampu → print (tetap ada footer,
114
- // hanya tidak lengket) — bukan none.
115
- const mode: "sticky" | "print" | "none" =
116
- !sticky && want === "off" ? "none" : useSticky ? "sticky" : "print"
117
- if (mode === "none") return makeNone()
118
- if (mode === "print") return makePrint(opts)
119
-
120
- // ── Sticky ──
121
- let regionOn = false
122
- let detached = false
123
- let resizeBound: (() => void) | null = null
124
- // Geometri frame footer yang TERAKHIR dilukis (jumlah baris saat itu).
125
- // Invarian: repaint SELALU menghapus frame lama dulu bila geometri berubah
126
- // dan baris lama masih teralamatkan — tanpa ini setiap resize meninggalkan
127
- // satu kopi footer yatim di scrollback (duplikat menumpuk tiap siklus
128
- // besar-kecil, terbukti oleh model VT: 5 resize → 4 kopi). null = tidak ada
129
- // frame hidup (belum pernah / sudah dilepas / geometri tak teralamatkan).
130
- let paintedRows: number | null = null
131
- // Pulse spark: frame naik saat busy. Timer HANYA hidup selama turn; idle =
132
- // frame 0 (spark redup). Fail-safe: callback timer dibungkus try/catch dan
133
- // tak pernah menyentuh jalur turn — animasi mati, turn tetap jalan.
134
- let frame = 0
135
- let pulseTimer: ReturnType<typeof setInterval> | undefined
136
- const stopPulse = (): void => {
137
- if (pulseTimer) {
138
- clearInterval(pulseTimer)
139
- pulseTimer = undefined
140
- }
141
- }
142
-
143
- // Lukis 2 baris dasar TANPA menggeser kursor pemanggil (DECSC/DECRC).
144
- // Penting untuk refresh() saat prompt aktif: repaint footer tidak boleh
145
- // memindahkan posisi ketik, kalau tidak render berikutnya menimpa footer.
146
- const paintFooter = (r: number): void => {
147
- const cols = process.stdout.columns || 80
148
- const [status] = renderFooter({ ...opts.status(), sparkFrame: frame }, cols)
149
- process.stdout.write(SAVE_CURSOR)
150
- // Blank di r-1, status di r (tanpa garis — clean).
151
- process.stdout.write(`\x1b[${r - 1};1H${CLEAR}`)
152
- process.stdout.write(`\x1b[${r};1H${CLEAR}${status}`)
153
- process.stdout.write(RESTORE_CURSOR)
154
- }
155
-
156
- const enableRegion = (r: number): void => {
157
- if (detached) return
158
- // DECSTBM memindahkan kursor ke home di sebagian emulasi VT — simpan/
159
- // kembalikan agar set region tidak melompatkan kursor ketik.
160
- process.stdout.write(SAVE_CURSOR)
161
- // Region atas = 1..r-2 (footer blank+status menempati r-1..r).
162
- process.stdout.write(`\x1b[1;${r - 2}r`)
163
- process.stdout.write(RESTORE_CURSOR)
164
- regionOn = true
165
- }
166
-
167
- // Hapus frame footer yang sedang hidup (bila teralamatkan). Dipakai saat
168
- // geometri berubah (eraseOldFrame) dan saat detach (frame lengket tak boleh
169
- // tertinggal sebagai duplikat salinan scrollback).
170
- const erasePaintedFrame = (): void => {
171
- if (paintedRows === null) return
172
- const r = rows()
173
- if (paintedRows - 1 >= 1 && paintedRows <= r) {
174
- process.stdout.write(SAVE_CURSOR)
175
- process.stdout.write(`\x1b[${paintedRows - 1};1H${CLEAR}`)
176
- process.stdout.write(`\x1b[${paintedRows};1H${CLEAR}`)
177
- process.stdout.write(RESTORE_CURSOR)
178
- }
179
- paintedRows = null
180
- }
181
-
182
- // Hapus frame footer LAMA bila geometri berubah dan barisnya masih
183
- // teralamatkan di layar saat ini. Bila layar menyusut di bawah frame lama
184
- // (paintedRows > r), frame lama sudah menjadi scrollback dan tak bisa
185
- // dihapus via pengalamatan — catat null (jujur: yatim, bukan hidup) agar
186
- // repaint berikut tidak salah mengira ada frame yang dijaga.
187
- const eraseOldFrame = (r: number): void => {
188
- if (paintedRows === null || paintedRows === r) return
189
- erasePaintedFrame()
190
- }
191
-
192
- // Satu-satunya jalur yang menyentuh region/frame (present, refresh,
193
- // setBusy, onResize SEMUA lewat sini): reset dulu (rekonsiliasi — region
194
- // bisa hilang diam-diam saat resize ConPTY atau program anak me-reset;
195
- // keyakinan lokal `regionOn` tak pernah dipercaya), lalu tegakkan region
196
- // baru + hapus frame lama + lukis frame baru (kecuali pemanggil melukis
197
- // sendiri dalam bingkai SYNC-nya, mis. present). Tiap pemanggilan sinkron
198
- // penuh — tak ada interleaving antar-repaint (JS single thread), jadi
199
- // state selalu konsisten antar-repaint tanpa lock.
200
- const reconcile = (r: number, paint = true): void => {
201
- if (detached) return
202
- process.stdout.write(SAVE_CURSOR)
203
- process.stdout.write(RESET_REGION)
204
- process.stdout.write(RESTORE_CURSOR)
205
- regionOn = false
206
- if (r < 10) {
207
- // Terlalu pendek: jangan tegakkan apa pun. Frame hidup (bila ada)
208
- // kemungkinan besar terdorong reflow ke 2 baris dasar layar kecil —
209
- // bersihkan keduanya agar tak menjadi duplikat permanen saat tumbuh
210
- // kembali (bukti model VT: susut-ke-8 lalu tumbuh → 2 footer hidup).
211
- // Bila reflow justru memotong bawah, ini hanya mengosongkan 2 baris
212
- // viewport (scrollback utuh, pulih oleh output berikut) — tak pernah
213
- // menyentuh baris di luar 2 dasar. Tanpa frame hidup: diam total.
214
- if (paintedRows !== null && r >= 2) {
215
- process.stdout.write(SAVE_CURSOR)
216
- process.stdout.write(`\x1b[${r - 1};1H${CLEAR}`)
217
- process.stdout.write(`\x1b[${r};1H${CLEAR}`)
218
- process.stdout.write(RESTORE_CURSOR)
219
- }
220
- paintedRows = null
221
- return
222
- }
223
- enableRegion(r)
224
- eraseOldFrame(r)
225
- if (paint) {
226
- paintFooter(r)
227
- paintedRows = r
228
- }
229
- }
230
-
231
- const onResize = (): void => {
232
- try {
233
- if (detached) return
234
- // Resize = invalidasi total: geometri lama mati, rekonsiliasi penuh.
235
- // Sengaja TANPA early-return regionOn — keyakinan lokal bisa basi.
236
- reconcile(rows())
237
- } catch {}
238
- }
239
-
240
- const handle: FooterChrome = {
241
- mode,
242
- reserveRows() {
243
- // Setelah detach, tidak ada jatah lagi (reset region sudah lepas).
244
- return detached ? 0 : FOOTER_ROWS
245
- },
246
- refresh() {
247
- if (detached) return
248
- try {
249
- // Sama seperti present tapi tanpa memindahkan kursor (prompt aktif).
250
- reconcile(rows())
251
- } catch {}
252
- },
253
- setBusy(busy: boolean) {
254
- if (detached) return
255
- try {
256
- if (busy) {
257
- if (pulseTimer) return
258
- // Frame naik pelan (2 tick/frame) agar glow halus, bukan strobo.
259
- pulseTimer = setInterval(() => {
260
- try {
261
- frame += 1
262
- // Lewat reconcile (bukan paint langsung): resize di tengah turn
263
- // ikut menyembuhkan region + menghapus frame lama, bukan
264
- // menumpuk frame baru di atasnya.
265
- reconcile(rows())
266
- } catch {
267
- // Runtime rewel: matikan animasi, jangan pernah gagalkan turn.
268
- stopPulse()
269
- }
270
- }, 150)
271
- } else {
272
- stopPulse()
273
- frame = 0
274
- reconcile(rows()) // kembali redup seketika
275
- }
276
- } catch {}
277
- },
278
- present() {
279
- if (detached) return
280
- try {
281
- const r = rows()
282
- if (r < 10) return // terminal terlalu pendek — jangan sentuh apa pun
283
- if (!regionOn) {
284
- if (!resizeBound) {
285
- resizeBound = onResize
286
- try {
287
- process.stdout.on("resize", onResize)
288
- } catch {}
289
- }
290
- }
291
- // Rekonsiliasi TANPA lukis (paint=false): lukisan dilakukan sekali di
292
- // bawah dalam bingkai SYNC agar tak ada frame ganda per present.
293
- reconcile(r, false)
294
- // Satu frame sinkron agar repaint footer tidak robek.
295
- process.stdout.write(SYNC_START)
296
- paintFooter(r)
297
- paintedRows = r
298
- // Kursor ke baris input (tepat di atas blank footer — kini 2 baris total).
299
- process.stdout.write(`\x1b[${r - 2};1H`)
300
- process.stdout.write(SYNC_END)
301
- } catch {}
302
- },
303
- detach() {
304
- if (detached) return
305
- detached = true
306
- stopPulse()
307
- try {
308
- if (resizeBound) {
309
- try {
310
- process.stdout.off("resize", onResize)
311
- } catch {}
312
- resizeBound = null
313
- }
314
- // Hapus frame lengket dulu agar salinan scrollback di bawah bukan
315
- // duplikatnya (sebelumnya: reset lalu cetak → dua baris status
316
- // terlihat bersamaan sesaat).
317
- erasePaintedFrame()
318
- if (regionOn) {
319
- process.stdout.write(RESET_REGION)
320
- regionOn = false
321
- }
322
- if (activeReserve === FOOTER_ROWS) activeReserve = 0
323
- // Cetak footer sekali sebagai baris normal agar layar terakhir tetap
324
- // memberi konteks tanpa region.
325
- if (mode === "sticky") {
326
- const cols = process.stdout.columns || 80
327
- const [status] = renderFooter(opts.status(), cols)
328
- process.stdout.write(`\n${status}\n`)
329
- }
330
- } catch {}
331
- },
332
- }
333
- activeReserve = FOOTER_ROWS
334
- return handle
335
- }
336
-
337
- function makePrint(opts: FooterChromeOptions): FooterChrome {
338
- activeReserve = 0
339
- const handle: FooterChrome = {
340
- mode: "print",
341
- reserveRows() {
342
- return 0
343
- },
344
- refresh() {},
345
- setBusy() {},
346
- present() {
347
- try {
348
- if (!process.stdout.isTTY) return
349
- const cols = process.stdout.columns || 80
350
- const [status] = renderFooter(opts.status(), cols)
351
- process.stdout.write(`\n${status}\n`)
352
- } catch {}
353
- },
354
- detach() {},
355
- }
356
- return handle
357
- }
358
-
359
- function makeNone(): FooterChrome {
360
- activeReserve = 0
361
- return {
362
- mode: "none",
363
- reserveRows: () => 0,
364
- present() {},
365
- refresh() {},
366
- setBusy() {},
367
- detach() {},
368
- }
369
- }
@@ -1,61 +0,0 @@
1
- // Primitive overlay transient untuk layar interaktif.
2
- //
3
- // Tujuan: satu tempat untuk logika redraw + clear (delete line) yang dipakai
4
- // picker/provider-manager/model-manager. Ini menjaga perilaku shell-like tetap
5
- // konsisten: overlay hanya sementara, tidak menyentuh scrollback permanen.
6
-
7
- export const CLEAR = "\x1b[2K"
8
- export const SYNC_START = "\x1b[?2026h"
9
- export const SYNC_END = "\x1b[?2026l"
10
-
11
- /**
12
- * Render ulang overlay dari anchor baris saat ini.
13
- * Mengembalikan jumlah baris overlay terbaru untuk dipakai render berikutnya.
14
- */
15
- export function renderTransientOverlay(lines: string[], prevRows: number): number {
16
- const next = lines.length
17
- // Non-TTY (pipe/redirect/CI): NOL byte kontrol — kontrak I6. Pemanggil
18
- // interaktif sudah menjaga via stdin.isTTY; guard di titik emisi menutup
19
- // pemakai langsung di masa depan (defense-in-depth, pola chrome.ts).
20
- if (!process.stdout.isTTY) return next
21
- const max = Math.max(prevRows, next)
22
- process.stdout.write(SYNC_START)
23
- if (max > 0) {
24
- process.stdout.write("\r\n")
25
- for (let k = 0; k < max; k++) {
26
- process.stdout.write(CLEAR)
27
- if (k < max - 1) process.stdout.write("\r\n")
28
- }
29
- process.stdout.write(`\x1b[${max}A`)
30
- }
31
- if (next > 0) {
32
- process.stdout.write("\r\n")
33
- for (let i = 0; i < next; i++) {
34
- process.stdout.write(CLEAR + (lines[i] ?? ""))
35
- if (i < next - 1) process.stdout.write("\r\n")
36
- }
37
- process.stdout.write(`\x1b[${next}A`)
38
- }
39
- process.stdout.write(SYNC_END)
40
- return next
41
- }
42
-
43
- /**
44
- * Hapus overlay dengan delete-line agar tidak menyisakan gap kosong.
45
- * Mengembalikan 0 (overlay sudah bersih).
46
- */
47
- export function clearTransientOverlay(prevRows: number): number {
48
- // Lihat guard di renderTransientOverlay — alasan sama (kontrak I6).
49
- if (!process.stdout.isTTY) return 0
50
- process.stdout.write(SYNC_START)
51
- if (prevRows > 0) {
52
- process.stdout.write("\r\n")
53
- for (let k = 0; k < prevRows; k++) {
54
- process.stdout.write(CLEAR)
55
- process.stdout.write("\x1b[1M")
56
- }
57
- process.stdout.write("\x1b[1A")
58
- }
59
- process.stdout.write(SYNC_END)
60
- return 0
61
- }