minicode-ai 0.26.0 → 0.28.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 (139) hide show
  1. package/cli/args.ts +120 -16
  2. package/cli/commands/acp.ts +38 -28
  3. package/cli/commands/auth.ts +17 -17
  4. package/cli/commands/config.ts +65 -66
  5. package/cli/commands/daemon.ts +44 -16
  6. package/cli/commands/doctor.ts +11 -12
  7. package/cli/commands/exec.ts +35 -73
  8. package/cli/commands/mcp.ts +25 -8
  9. package/cli/commands/memory.ts +16 -24
  10. package/cli/commands/openwork.ts +6 -2
  11. package/cli/commands/pricing.ts +14 -12
  12. package/cli/commands/providers.ts +36 -57
  13. package/cli/commands/sessions.ts +24 -18
  14. package/cli/commands/skills.ts +33 -18
  15. package/cli/commands/stats.ts +15 -30
  16. package/cli/commands.ts +96 -46
  17. package/cli/context-command-run.ts +171 -0
  18. package/cli/context-command.ts +87 -0
  19. package/cli/index.ts +96 -98
  20. package/cli/model-manager.ts +7 -2
  21. package/cli/provider-manager.ts +33 -18
  22. package/cli/router.ts +41 -12
  23. package/cli/setup.ts +246 -123
  24. package/cli/tui.ts +311 -109
  25. package/docs/TERMINAL_CONTRACT.md +254 -69
  26. package/docs/UI_RENDER_PIPELINE.md +9 -1
  27. package/docs/agents.md +2 -2
  28. package/docs/architecture.md +3 -3
  29. package/docs/choosing-mode.md +7 -9
  30. package/docs/cli.md +3 -5
  31. package/docs/config.md +16 -0
  32. package/docs/environment.md +3 -3
  33. package/docs/policy-sandbox.md +3 -3
  34. package/docs/repl.md +3 -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 +119 -66
  40. package/src/app/tool-layer.ts +12 -17
  41. package/src/config.ts +64 -104
  42. package/src/constants.ts +23 -9
  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/db-path.ts +47 -0
  48. package/src/lib/process-tree.ts +62 -0
  49. package/src/lib/public-http.ts +88 -23
  50. package/src/lib/trusted-exec.ts +48 -1
  51. package/src/lsp/client.ts +62 -17
  52. package/src/mcp/client.ts +85 -38
  53. package/src/mcp/http-transport.ts +28 -16
  54. package/src/mcp/transport.ts +42 -6
  55. package/src/memory/files.ts +164 -134
  56. package/src/memory/vector.ts +371 -420
  57. package/src/policy/approval-binding.ts +122 -45
  58. package/src/policy/bash-guard.ts +18 -7
  59. package/src/policy/compaction.ts +51 -18
  60. package/src/policy/context-window.ts +109 -0
  61. package/src/policy/context.ts +78 -37
  62. package/src/policy/executor.ts +17 -7
  63. package/src/policy/microcompact.ts +4 -3
  64. package/src/policy/no-progress.ts +103 -22
  65. package/src/policy/permission.ts +36 -12
  66. package/src/policy/tool-contract.ts +74 -416
  67. package/src/policy/usage.ts +24 -2
  68. package/src/policy/verifier.ts +50 -2
  69. package/src/policy/work-mode.ts +28 -54
  70. package/src/presentation/adapter.ts +24 -16
  71. package/src/providers/guards.ts +41 -2
  72. package/src/providers/provision.ts +6 -60
  73. package/src/providers/responses.ts +1 -0
  74. package/src/repo/repomap.ts +180 -23
  75. package/src/runtime/execution-journal.ts +4 -29
  76. package/src/sandbox/docker.ts +58 -34
  77. package/src/sandbox/mask.ts +157 -0
  78. package/src/sandbox/os.ts +107 -73
  79. package/src/session/authority.ts +29 -10
  80. package/src/session/context-projection.ts +6 -5
  81. package/src/session/open-work.ts +26 -3
  82. package/src/session/persistence.ts +25 -58
  83. package/src/session/verification.ts +170 -20
  84. package/src/skills/loader.ts +31 -16
  85. package/src/task/production-scheduler.ts +13 -1
  86. package/src/task/store.ts +20 -37
  87. package/src/telemetry/trace.ts +27 -0
  88. package/src/tools/ask_user.ts +1 -13
  89. package/src/tools/bash.ts +27 -92
  90. package/src/tools/code_run.ts +1 -1
  91. package/src/tools/context.ts +133 -0
  92. package/src/tools/delete_file.ts +3 -2
  93. package/src/tools/edit.ts +37 -72
  94. package/src/tools/git.ts +86 -9
  95. package/src/tools/glob.ts +26 -51
  96. package/src/tools/grep.ts +67 -57
  97. package/src/tools/hashline.ts +4 -0
  98. package/src/tools/lsp.ts +11 -8
  99. package/src/tools/mcp_call.ts +9 -6
  100. package/src/tools/memory.ts +56 -33
  101. package/src/tools/move_file.ts +36 -10
  102. package/src/tools/patch.ts +13 -21
  103. package/src/tools/read_file.ts +18 -25
  104. package/src/tools/read_image.ts +35 -33
  105. package/src/tools/submit_result.ts +29 -8
  106. package/src/tools/task.ts +74 -17
  107. package/src/tools/todo.ts +181 -74
  108. package/src/tools/web_fetch.ts +42 -2
  109. package/src/tools/web_search.ts +47 -8
  110. package/src/ui/approval/prompt.ts +206 -47
  111. package/src/ui/assistant/turn-status.ts +14 -5
  112. package/src/ui/footer.ts +4 -4
  113. package/src/ui/i18n/en.ts +59 -23
  114. package/src/ui/i18n/id.ts +88 -51
  115. package/src/ui/input/input.ts +4 -3
  116. package/src/ui/input/prompt-engine.ts +35 -5
  117. package/src/ui/render/activity-panel.ts +4 -2
  118. package/src/ui/render/hint.ts +7 -4
  119. package/src/ui/render/list.ts +32 -0
  120. package/src/ui/render/markdown.ts +6 -3
  121. package/src/ui/render/notice.ts +19 -0
  122. package/src/ui/render/table-grid.ts +7 -8
  123. package/src/ui/render/theme.ts +113 -39
  124. package/src/ui/runtime/screen.ts +74 -10
  125. package/src/ui/runtime/spinner.ts +19 -6
  126. package/src/ui/screens/dialog.ts +19 -1
  127. package/src/ui/screens/form.ts +80 -35
  128. package/src/ui/screens/model-manager.ts +88 -62
  129. package/src/ui/screens/output-window.ts +263 -0
  130. package/src/ui/screens/picker.ts +94 -81
  131. package/src/ui/screens/provider-manager.ts +100 -69
  132. package/src/ui/screens/wizard.ts +117 -28
  133. package/src/ui/tui/app.ts +196 -33
  134. package/src/ui/tui/transcript.ts +154 -25
  135. package/vendor/minicore/src/core/executor.ts +2 -0
  136. package/vendor/minicore/src/core/loop.ts +17 -6
  137. package/vendor/minicore/src/core/session.ts +3 -0
  138. package/vendor/minicore/src/core/tool.ts +1 -0
  139. package/vendor/minicore/src/providers/openai-compat.ts +28 -19
@@ -1,4 +1,120 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.15, unreleased)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.19, unreleased)
2
+
3
+ Perubahan v7.19 (remediasi audit & ergonomi UX):
4
+
5
+ 1. **Dropdown `/` mendukung penyelesaian `Tab`.** Ketika menu `/` sedang terbuka
6
+ dan memiliki kandidat, `Tab` melengkapi nama command terpilih (atau kandidat
7
+ teratas) ke composer (`menuOpen` menutup tanpa eksekusi langsung); ketika
8
+ dropdown tertutup atau tidak ada kandidat, `Tab` tetap memutar `WorkMode`
9
+ (`Discuss → Plan → Build`).
10
+ 2. **Jendela output command interaktif penuh.** `runOutputWindow` menghitung ulang
11
+ wrap dan lebar kotak secara dinamis saat `resize`, mempertahankan posisi
12
+ scroll proporsional, menampilkan counter posisi di judul saat scrollable,
13
+ menyembunyikan hint scroll saat pas 1 layar, menerima `wheelup`/`wheeldown`/
14
+ `j`/`k`/`Space`, serta mendukung salin isi jendela via tombol `c` ketika
15
+ `onCopy` disediakan.
16
+ 3. **Modal & formulir adaptif.** Picker, manager model, dan manager penyedia
17
+ mendukung `wheelup`/`wheeldown` serta menjaga `visibleRows` tetap positif
18
+ meski pesan notice membungkus; form men-stack label panjang di atas baris
19
+ input agar lebar field minimal tetap terjaga, dan menyaring byte kontrol C1
20
+ (`\u0080–\u009f`); wizard menjaga pesan error sampai user menekan Enter/Esc.
21
+ 4. **Zero-state, ritme transkrip, seleksi akurat, & ASCII konsisten.**
22
+ Saat transkrip kosong dan idle, header sambutan ringkas tampil di area
23
+ kosong tanpa menambah baris frame atau mengubah baris spacer. Transkrip
24
+ menambahkan jeda antar-turn sebelum `pushUser`, header bahasa redup pada
25
+ pembuka code fence berbahasa, serta pemetaan `displayStart` dan teks inline
26
+ untuk akurasi `pointAt`/`columnAtOffset`. `Shift+Enter`/`Alt+Enter` modern
27
+ (`\x1b\r`, `\x1b[13;2u`, `\x1b[27;2;13~`) disambungkan ke newline (`ctrl-j`),
28
+ bracketed paste tak-tertutup dibatasi 512 KiB, dan seluruh divider/ellipsis/
29
+ marker mengikuti `glyphs.*` (`MINICODE_ASCII=1`).
30
+
31
+ 5. **Konsistensi penuh Layer 2 overlay & backdrop adaptif (v7.19).**
32
+ - Semua permukaan Layer 2 (`picker`, `model-manager`, `provider-manager`,
33
+ `output-window`, `form`, `approval`, `ask_user`, `/sync`, `wizard`)
34
+ memakai `spec.footer` yang dipin di luar clipping window `dialogBox`, dan
35
+ `dialogBox` tidak membungkus ulang footer ber-SGR agar warna tombol
36
+ `hintLine` / peringatan tetap kontras dan bersih.
37
+ - `runPicker` nested di dalam manager/wizard menerima `screen` induk dan
38
+ induk menghapus regionnya sebelum sub-modal dilukis — meniadakan bingkai
39
+ induk terpotong di belakang anak.
40
+ - `registerScreenBackdrop` + `regionEpoch` memastikan backdrop redup
41
+ Layer 1 dipulihkan saat kotak menyusut/tertutup/resize tanpa `ESC[2J`
42
+ penuh, sekaligus menjamin `TuiApp.resume()` melukis ulang sel tertutup
43
+ meski `NO_COLOR=1`.
44
+ - `form`, `picker`, `approval`, dan `ask_user` kini mengikuti `resize`
45
+ secara dinamis, menjaga batas minimum `canRenderModal` (`20×10`),
46
+ menggunakan `glyphs.arrow` untuk echo approval/`ask_user`, menangani
47
+ `wheel` (di approval & dropdown `/`), menyembunyikan kursor di jendela
48
+ non-ketik (read-only / list-only / progres), serta menampilkan progres
49
+ `/sync` langsung di Layer 2 dan mengarahkan warning reload manager ke
50
+ notice/captured log alih-alih menulis mentah ke `stderr`.
51
+
52
+ Perubahan v7.18 (jendela output command):
53
+
54
+ 1. **Output command readout tampil sebagai JENDELA di atas chat.** `/help`,
55
+ `/status`, `/context`, `/history`, `/expand`, `/sync`, `/init`, `/scheduler`
56
+ (dan alias `/cost`/`/usage`) tidak lagi dicetak ke transkrip. Output-nya
57
+ dibuka di overlay read-only `runOutputWindow` (`src/ui/screens/
58
+ output-window.ts`) dengan judul, body, dan hint; transkrip/chat tidak
59
+ tersentuh dan tidak bergeser. Receipt aksi pendek (`/undo`, `/redo`,
60
+ `/copy`, toggle) tetap di transkrip.
61
+ 2. **Format jendela command seragam.** Output window dan jendela interaktif
62
+ (`/model`, `/provider`, `/sessions`, picker preset/effort) memakai chrome
63
+ yang sama: `dialogBox` (border + judul) dan `hintLine` minimalis; jendela
64
+ interaktif memakai `listRow` untuk baris daftar. Jendela interaktif command
65
+ kini berjudul (Models/Providers/Sessions/…); output window memakai lebar
66
+ lega `outputWindowWidth(cols)` (56–96 kolom) agar tabel/help terbaca.
67
+ 3. **Scroll & tutup.** Output window mendukung `↑↓`, `PgUp/PgDn`, `Home/End`,
68
+ tutup via `Esc`/`Enter`/`Ctrl+C`/`Ctrl+D`; idle 90 dtk auto-tutup. Bila layar
69
+ tak mampu (non-TTY/terlalu kecil) atau setup gagal, fungsi mengembalikan
70
+ `false` dan pemanggil WAJIB fallback mencetak output ke transkrip — output
71
+ tidak pernah hilang.
72
+ 4. **Dropdown `/` tetap inline** mengikuti prompt (perilaku v7.8/v7.15); ia
73
+ BUKAN bagian dari perubahan jendela output command.
74
+
75
+ Perubahan v7.16 (remediasi konsistensi UI/UX):
76
+
77
+ 1. **Grammar hint minimalis diseragamkan.** Semua permukaan (picker, manager
78
+ model/penyedia, form, approval, ask_user, dialog hapus) memakai satu baris
79
+ `kunci label kunci label` — kunci accent, label redup, **pemisah hanya
80
+ spasi** (tanpa `·`, titik dua, atau awalan/akhiran). Hint mengikuti state:
81
+ picker/manager saat filter terisi menampilkan `Esc kosongkan/kembali`, dan
82
+ form saat field aktif `select`/`confirm` menampilkan `←→` / `←→/y/n`.
83
+ Panah, chevron, caret, dan marker seleksi memakai getter `glyphs` sehingga
84
+ `MINICODE_ASCII=1` tetap menghasilkan teks ASCII.
85
+ 2. **Footer form dinamis, bukan template ber-placeholder.** `form.footerDefault`
86
+ dengan `{move}`/`{save}`/`{cancel}` dihapus; footer dibangun dari `hintLine`
87
+ (atau `footerHints` untuk dialog hapus). Tidak ada lagi placeholder literal
88
+ di form wizard/provider.
89
+ 3. **Approval & ask_user:** idle guard 80+10 dtk mulai saat modal DIBUKA (bukan
90
+ setelah keypress), peringatan dirender di footer; kursor diparkir di opsi
91
+ aktif/baris input; opsi terpilih memakai marker `›` dengan kolom marker tetap
92
+ dan `focusRow` menjaga opsi terpilih tetap terlihat; sinonim quick-key tanpa
93
+ opsi (mis. `s` saat Always disembunyikan) diabaikan, bukan deny diam-diam.
94
+ ask_user mendapat hint `Enter kirim Esc batal`.
95
+ 4. **Picker wizard menampilkan judul lewat opt-in `showTitle`.** Step
96
+ `Minicode setup [1/3]` kembali terlihat. (v7.18 memperluas judul ke semua
97
+ jendela command: Models/Providers/Sessions/effort/Add provider.)
98
+ 5. **Palette level-aware:** token semantik memilih SGR 16-warna, 256-warna, atau
99
+ truecolor sesuai `colorLevel()`; terminal 16-warna tidak lagi menerima
100
+ `38;2;...`. Discuss di footer memakai accent (bukan warning) karena mode
101
+ default bukan peringatan.
102
+ 6. **Notice aksi manager memakai formatter kanonik** (`formatError`, redaksi
103
+ credential) dan dirender sebagai error merah/sukses hijau/info redup; output
104
+ `/sync`/`providers` menyertakan kata status, bukan warna saja.
105
+ 7. **Registry `/help` lengkap:** command View (`compact`, `thinking`, `expand`,
106
+ `minimize`, `fold`) terdaftar, sehingga `/help full` tidak lagi memuat
107
+ heading grup kosong. Receipt toggle command = receipt hotkey (label state
108
+ terlokalisasi lewat `state.*`).
109
+ 8. **Seleksi tabel mode ASCII:** baris border fallback `+---+` dikenali sebagai
110
+ border (bukan data), sehingga source mapping seleksi tabel tetap utuh dan
111
+ baris border tidak ikut terseleksi.
112
+
113
+ Peta proteksi baru: `test/hint-grammar.test.ts` (grammar spasi-only, alignment
114
+ `listRow`; ASCII fallback glyph tetap dikunci `test/cli-help-language.test.ts`),
115
+ `test/theme-levels.test.ts` (SGR per level),
116
+ `test/form.test.ts` (footer tanpa placeholder + hint select), dan
117
+ `test/approval-tui.test.ts` (cursor parkir, quick-key guard, hint ask_user).
2
118
 
3
119
  Perubahan v7.15 (remediasi audit): CSI/SS3 malformed dibuang sampai byte
4
120
  independen berikutnya; Ctrl+C/Ctrl+D tetap dapat didekode. Prefix kontrol
@@ -111,9 +227,9 @@ di luar code fence; isi code fence tetap literal.
111
227
  Perubahan v7.8: sesi baru dan sesi legacy tanpa WorkMode mulai di `Discuss`;
112
228
  operator hanya dapat memilih `Discuss`, `Plan`, atau `Build`. Permission Mode
113
229
  awal `Auto` dan kontrolnya hanya `Auto`/`Ask`. Dropdown `/` menampilkan nama
114
- command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
115
- model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
116
- ringkas.
230
+ command tanpa slash, judul, deskripsi, atau baris tambahan. (Sejak v7.18
231
+ jendela command memakai judul konteks; dropdown `/` tetap tanpa judul.) Baris
232
+ provider/model dibuat ringkas.
117
233
 
118
234
  Perubahan v7.7 (diperbarui v0.24): footer menampilkan nilai Work Mode di sisi
119
235
  kiri dan nilai Permission Mode di sisi kanan dekat pemakaian konteks. Label
@@ -230,8 +346,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
230
346
  mengaktifkan tracking drag; `?1000h + ?1006h` saat popup; `?1000l/?1002l/?1006l`
231
347
  pada quit/child/sinyal. Suspend menahan repaint (popup melukis sendiri);
232
348
  quit menahan semua.
233
- - Popup komposit (`/model`, `/provider`, `/sessions`, form, approval):
234
- controller/view memanggil `app.suspend()` (lepas listener stdin + redupkan
349
+ - Popup komposit (`/model`, `/provider`, `/sessions`, output command, form,
350
+ approval): controller/view memanggil `app.suspend()` (lepas listener stdin + redupkan
235
351
  layar), view melukis HANYA region kotak via `paintRegion` (tanpa clear —
236
352
  transkrip di belakang tetap tampil), `app.resume()` repaint penuh saat tutup.
237
353
  Tanpa suspend: byte masuk ke dua tempat (App + popup) dan frame App menimpa
@@ -265,8 +381,11 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
265
381
  atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
266
382
  `dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
267
383
  sendiri.
268
- - **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 64,
269
- form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
384
+ - **Lebar kotak popup adaptif** di semua permukaan (`popupBoxWidth(cols)`
385
+ untuk popup/form/approval/picker, `outputWindowWidth(cols)` untuk jendela
386
+ output command): dievaluasi dari lebar terminal saat render/resize agar
387
+ selalu center dan tak overflow, sambil menjaga lebar tetap antar frame
388
+ selama lebar terminal sama (tidak "bernapas" saat filter/error muncul).
270
389
  Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
271
390
  hilang, id selamat).
272
391
  - Form dalam popup (`form.ts`): field text/secret(mask `•`)/select/confirm,
@@ -282,10 +401,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
282
401
  mengosongkan filter. Tidak ada draft yang hilang tanpa undo.
283
402
  - Dropdown `/` tetap inline menempel prompt (harus mengikuti kursor ketik):
284
403
  berbingkai, terhapus di SEMUA jalur keluar.
285
- - **Kursor diparkir di SEMUA permukaan** (picker/manager/form/App): baris
286
- item/field aktif — bukan ditinggal di posisi paint terakhir. Kursor idle App
287
- berada tepat setelah prompt `minicode ›` (prompt tidak lagi disembunyikan
288
- setelah Esc/Enter kosong — I13).
404
+ - **Kursor konsisten di permukaan ketik vs baca** (`form`/`model-manager`/
405
+ `picker` ber-filter/`approval`/App memarkir kursor via `screen.moveCursor`;
406
+ `output-window`, `provider-manager` list-only, `picker` non-filter, dan
407
+ status progres/error wizard menyembunyikan kursor via `screen.setCursorVisible(false)`
408
+ agar tampilan tetap minimalis dan bersih). Kursor idle App berada tepat
409
+ setelah prompt `minicode ›` (I13).
289
410
  - **i18n dwibahasa** (`src/ui/i18n/`): kamus statis `en.ts`/`id.ts` (id WAJIB
290
411
  kunci = en — tsc mengawal), `t(key, params)` interpolasi `{nama}`, fallback
291
412
  kunci hilang → en. Prioritas: `/lang` (sesi) > `MINICODE_LANG` >
@@ -303,22 +424,33 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
303
424
  `Del` + confirm dalam popup, tercatat); navigasi daftar = `↑↓` + `pgup/
304
425
  pgdn` + `home/end` di semua popup ber-daftar; hint footer tiap permukaan
305
426
  hanya tombol yang benar-benar berlaku di sana.
306
- - **Hint aksi minimalis** (audit UI/UX 2026-11): satu baris di dasar body
307
- picker/manager (`src/ui/render/hint.ts`, satu sumber), format `kunci label`
308
- — kunci lebih terang, label redup, pemisah `·` — tanpa judul dan tanpa
309
- footer dekoratif di dalam kotak. `/model`: **Enter = pilih model satu
427
+ - **Hint aksi minimalis** (audit UI/UX 2026-11; diseragamkan v7.16): satu baris
428
+ di dasar body picker/manager/form/approval (`src/ui/render/hint.ts`, satu
429
+ sumber), format `kunci label kunci label` — kunci accent, label redup,
430
+ **pemisah hanya spasi** (tanpa `·`/titik dua) — tanpa footer dekoratif.
431
+ Judul jendela command mengikuti konteks (Models/Providers/Sessions/Help/…),
432
+ bukan bagian hint. Hint mengikuti state (filter terisi vs kosong;
433
+ select/confirm menampilkan panah/y-n). `/model`: **Enter = pilih model satu
310
434
  langkah** (tanpa picker effort); **Tab = ubah thinking effort** terpisah
311
435
  (Esc pada picker effort = batal effort, kembali ke daftar — manajer tak
312
436
  pernah menutup diri di sana).
437
+ - **Jendela output command** (`src/ui/screens/output-window.ts`, v7.18):
438
+ overlay read-only di ATAS transkrip untuk readout command (`/help`, `/status`,
439
+ `/context`, `/history`, `/expand`, `/sync`, `/init`, `/scheduler`, alias
440
+ `/cost`/`/usage`). Kotak berjudul + body ber-scroll (`↑↓`, `PgUp/PgDn`,
441
+ `Home/End`) + hint `↑↓ gulir Esc batal`; tutup `Esc`/`Enter`/`Ctrl+C`/
442
+ `Ctrl+D`; idle 90 dtk. Chat/transkrip tidak tersentuh. Non-TTY/terlalu
443
+ kecil/setup gagal → fallback transkrip (output tak hilang). Receipt aksi
444
+ pendek (`/undo`, `/redo`, `/copy`, toggle) tetap di transkrip.
313
445
  - Approval tool & ask_user: blok pertanyaan + keputusan DICATAT di transkrip
314
446
  (jejak audit) dan layar di-repaint sebelum menjawab; input via askLine di
315
447
  baris kursor (aman: input App beku saat busy; Esc/Ctrl+C = abort + deny).
316
448
  - Layar tak mampu (non-TTY, `rows < 10`, `TERM=dumb`): view menolak BERSUARA
317
449
  + batal (fail-closed). TAK BOLEH diam.
318
- - `/status` & `/history` = readout ke transkrip (bukan popup); `/help` ringkas
450
+ - `/status`, `/history`, `/help`, `/context`, `/expand` = jendela output
451
+ command read-only di atas chat (v7.18), bukan dump transkrip; `/help` ringkas
319
452
  (terkelompok ≤8 baris, penuh via `/help full`, pintasan via `/help keys`);
320
- `/expand` membuka buffer isi tool; pilihan `/model` persist antar sesi +
321
- struk `model: x` di transkrip.
453
+ pilihan `/model` persist antar sesi + struk `model: x` di transkrip.
322
454
 
323
455
  ## Invariant (nomor dipakai di peta proteksi)
324
456
 
@@ -436,17 +568,17 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
436
568
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
437
569
  oldest-to-newest) melalui OSC 52.
438
570
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
439
- 20. Lebar kotak popup **diskalakan dari lebar layar dan DIBEKUKAN saat mount**:
571
+ 20. Lebar kotak popup **diskalakan dari lebar layar secara dinamis saat resize**:
440
572
  `popupBoxWidth(cols) = min(max(40, min(88, floor(cols*0.6))), cols-4)`
441
- (v7.14 — dulu angka tetap 64 untuk model/picker/provider/form). Semua
573
+ (v7.14; adaptif `resize` di seluruh permukaan sejak v7.19). Semua
442
574
  permukaan popup (picker, model, provider, form, wizard, **approval**) memakai
443
575
  fungsi yang SAMA — tak ada permukaan yang memakai lebar layar penuh seperti
444
- approval sebelum v7.14 (AUD-007). Nilai dihitung sekali per mount lalu
445
- dikirim sebagai `minWidth == maxWidth` sehingga kotak tak "bernapas" selama
446
- popup terbuka, tetapi tiap mount menyesuaikan terminal. Margin 4 kolom
447
- SELALU menang atas lantai 40 (terminal < 44 kolom tidak overflow, AUD-011).
448
- Sudut kotak MELENGKUNG `╭ ╮ ╰ ╯` secara default; `MINICODE_BOX=square`
449
- mengembalikan lancip, `MINICODE_BOX=ascii`/`MINICODE_ASCII=1` ke ASCII.
576
+ approval sebelum v7.14 (AUD-007). Nilai dikirim sebagai `minWidth == maxWidth`
577
+ dari lebar `cols` aktif sehingga kotak tak "bernapas" selama ukuran layar
578
+ konstan, tetapi ikut menyesuaikan bila terminal diperbesar/diperkecil.
579
+ Margin 4 kolom SELALU menang atas lantai 40 (AUD-011). Sudut kotak MELENGKUNG
580
+ `╭ ╮ ╰ ╯` secara default; `MINICODE_BOX=square` mengembalikan lancip,
581
+ `MINICODE_BOX=ascii`/`MINICODE_ASCII=1` ke ASCII.
450
582
  Nama/ID di depan label; seleksi murni warna; search selalu tampil.
451
583
  21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
452
584
  select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
@@ -478,9 +610,10 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
478
610
  25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
479
611
  backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
480
612
  (`↑↓`, pgup/pgdn, home/end) di semua popup; hint aksi minimalis
481
- (`kunci label`, kunci terang/label redup) akurat per permukaan;
482
- kursor diparkir di semua permukaan; Enter `/model` = pilih satu
483
- langkah, Tab = ubah effort.
613
+ (`kunci label kunci label`, kunci accent/label redup, pemisah hanya
614
+ spasi) akurat per state permukaan; kursor diparkir di semua permukaan
615
+ (termasuk approval/ask_user); Enter `/model` = pilih satu langkah,
616
+ Tab = ubah effort.
484
617
  26. i18n dwibahasa: semua string user-visible lewat `t()`; id kunci = en
485
618
  (tsc mengawal); fallback kunci hilang → en; prioritas sesi > env >
486
619
  state.json > locale OS > en (di OS: `LC_ALL` > `LANG`, string kosong
@@ -549,22 +682,22 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
549
682
  — subcommand lain menerima args mentah. Invarian ini tidak mengubah
550
683
  semantik, aksi, atau exit code masing-masing aksi; yang berubah hanya
551
684
  invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
552
- 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
685
+ 35. **WorkMode = lapis intent 2-mode di ATAS permission mode (`DISCUSS` | `BUILD`)** — dua
553
686
  dimensi yang BERJALAN BERSAMA, bukan pengganti:
554
- **Nilai runtime:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
555
- lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
556
- (ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
557
- pengawasan eksplisit + ekstra rencana bila diizinkan Tool Access Policy) ·
558
- `EXECUTE` (tanpa ceiling tambahan). Nama produk `BUILD` memetakan ke
559
- identitas internal `EXECUTE`; sesi baru memakai default `DISCUSS`.
687
+ **Nilai runtime:** `DISCUSS` (investigasi baca-saja, diskusi, dan perencanaan:
688
+ 16 tool `PURE_READ` lokal + `web_fetch`/`web_search` yang wajib lewat
689
+ pengawasan eksplisit + ekstra rencana `todo_write`/`delegate_task` [explore]/
690
+ `submit_result` bila diizinkan Tool Access Policy) · `EXECUTE` (tanpa ceiling
691
+ tambahan). Nama produk `BUILD` memetakan ke identitas internal `EXECUTE`;
692
+ sesi baru memakai default `DISCUSS`.
560
693
  **Gerbang penolakan & side-effect ceiling:** Tool Access Policy menentukan
561
694
  capability yang tersedia; PermissionMode menentukan pengawasan persetujuan;
562
695
  WorkMode memasang ceiling tambahan. Irisan ketiganya tidak pernah
563
696
  memperluas akses (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
564
- hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
565
- ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
566
- serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
567
- **Command `/work-mode <DISCUSS|PLAN|BUILD>`:** tiga nilai produk yang dapat
697
+ hooks diblokir pada `DISCUSS` untuk semua PM, dan `--verify` ditolak
698
+ fail-closed saat startup bila digabung `DISCUSS` (exit 2) serta dilewati
699
+ otomatis saat mode turun ke `DISCUSS` di TUI.
700
+ **Command `/work-mode <DISCUSS|BUILD>`:** dua nilai produk yang dapat
568
701
  dipilih operator; `EXECUTE` hanya nama internal dan ditolak sebagai input.
569
702
  Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
570
703
  kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
@@ -578,8 +711,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
578
711
  **Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
579
712
  (`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
580
713
  (`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
581
- sesi (baris legacy tanpa `work_mode` kembali ke default `DISCUSS`; nilai
582
- tersimpan `EXECUTE` lama ditampilkan sebagai `BUILD`) dan
714
+ sesi (baris legacy tanpa `work_mode` atau bernilai `PLAN` kembali ke default
715
+ `DISCUSS`; nilai tersimpan `EXECUTE` lama ditampilkan sebagai `BUILD`) dan
583
716
  composition root menulis SATU baris stderr human-facing
584
717
  (`[resume] WorkMode <MODE> restored from session...` atau notice override/
585
718
  legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
@@ -588,22 +721,22 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
588
721
  **Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
589
722
  footer (Work Mode kiri; Permission Mode kanan), di one-shot/exec linear
590
723
  lewat SATU baris stderr human-facing `[work-mode] <MODE> …`, dan di
591
- `exec --json` lewat field `summary.workMode` dengan nilai produk `DISCUSS`,
592
- `PLAN`, atau `BUILD` — bukan teks dekoratif. ACP memakai `params.workMode`
724
+ `exec --json` lewat field `summary.workMode` dengan nilai produk `DISCUSS`
725
+ atau `BUILD` — bukan teks dekoratif. ACP memakai `params.workMode`
593
726
  (terstruktur) dan tak menambah baris
594
727
  dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
595
- vs `/mode`/`--plan`) dan dari status sesi.
596
- **Pemisahan dari PermissionMode:** `Tab` memutar WorkMode;
728
+ vs `/mode`) dan dari status sesi.
729
+ **Pemisahan dari PermissionMode:** `Tab` memutar WorkMode (`Discuss` ↔ `Build`);
597
730
  `Shift+Tab` dan `/mode` mengubah PermissionMode. PermissionMode menentukan
598
731
  pengawasan persetujuan (`AUTO`/`ASK`) dan Tool Access Policy menentukan
599
- capability. WorkMode memilih postur (diskusi/rencana/bebas) dan hanya
732
+ capability. WorkMode memilih postur (diskusi & rencana vs implementasi) dan hanya
600
733
  mempersempit akses.
601
734
  **Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
602
735
  **per pemanggilan** dengan WorkMode dan PermissionMode **AKTIF**. Hooks
603
- ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
736
+ ditahan pada WorkMode `DISCUSS` dan PermissionMode warisan
604
737
  `plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
605
738
  PermissionMode AUTO/ASK.
606
- **Footer:** Work Mode tampil di kiri (nilai `Build`/`Plan`/`Discuss`; alias
739
+ **Footer:** Work Mode tampil di kiri (nilai `Build`/`Discuss`; alias
607
740
  internal `EXECUTE` ditampilkan `Build`). Permission Mode tampil di kanan dekat
608
741
  token konteks sebagai nilai `Auto`/`Ask`. Label produk `Work Mode:` dan
609
742
  `Permission Mode:` dihapus v0.24 — nilai saja, lebih lega. Nilai Work Mode
@@ -612,10 +745,23 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
612
745
  `○` merah = unrestricted. Bila ada job background hidup, badge `◷ N` tampil
613
746
  di samping spark.
614
747
 
748
+ 36. **Output command readout = jendela overlay di atas chat (v7.18).**
749
+ `/help`, `/status`, `/context`, `/history`, `/expand`, `/sync`, `/init`,
750
+ `/scheduler`, dan alias `/cost`/`/usage` membuka `runOutputWindow`
751
+ (`paintRegion` + `dialogBox` berjudul + body ber-scroll + `hintLine`)
752
+ alih-alih mencetak ke transkrip; chat tidak berubah/bergeser. Navigasi
753
+ `↑↓`/`PgUp/PgDn`/`Home/End`; tutup `Esc`/`Enter`/`Ctrl+C`/`Ctrl+D`; idle
754
+ 90 dtk. Jendela interaktif command (`/model`, `/provider`, `/sessions`,
755
+ picker preset/effort) memakai chrome yang sama dan berjudul. Bila layar
756
+ tak mampu/setup gagal, view mengembalikan `false` dan output dicetak ke
757
+ transkrip (fail-open untuk data, fail-closed untuk overlay). Dropdown `/`
758
+ tetap inline dan TIDAK termasuk perubahan ini.
759
+
615
760
  ## Grammar (ringkas)
616
761
 
617
762
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
618
- berbingkai di atasnya) ·
763
+ berbingkai di atasnya; `Tab` melengkapi command terpilih saat terbuka, dan
764
+ memutar WorkMode saat tertutup) · zero-state welcome ringkas saat transkrip kosong/idle ·
619
765
  status bar `✦ 00.00.00 Discuss model cwd … context Auto ●`
620
766
  (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
621
767
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
@@ -628,7 +774,8 @@ kegagalan · pesan error TUI = formatter kanonik (`formatError`,
628
774
  ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
629
775
  pernah tampil · thinking: dots clock / alir thinking terbaca · popup: konten redup di
630
776
  belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
631
- `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
777
+ `/status`, `/history`, `/help`, `/context` & `/expand` tampil di jendela output
778
+ command di atas chat (v7.18) ·
632
779
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
633
780
  `/fold` = lipat aktivitas tool per turn (`MINICODE_MINIMIZE_ACTIVITY`, ON di TUI) —
634
781
  baris ledger per-tool dirangkum jadi SATU baris ringkas (`n tools · nama · x ok · y gagal`),
@@ -659,8 +806,10 @@ panjang).
659
806
  4. Terminal purba tanpa alternate screen: pesan satu baris + keluar (bukan error).
660
807
  5. Approval saat user scroll ke atas: blok tercatat di ekor (tak terlihat
661
808
  sampai PgDn), tapi prompt jawaban + bell selalu terlihat di bawah.
662
- 6. Area yang dibuka kembali saat kotak menyusut = kosong (bukan transkrip
663
- di belakangnya) sampai popup tutup + repaint penuh.
809
+ 6. Area backdrop yang terbuka kembali saat kotak Layer 2 menyusut atau resize
810
+ dipulihkan memakai snapshot redup `registerScreenBackdrop` tanpa `ESC[2J`;
811
+ bagian kiri/kanan pada baris yang sejajar secara horizontal dengan kotak
812
+ tetap bersih terpusat hingga `resume()` melakukan repaint penuh.
664
813
  7. Jalur end-to-end mouse SGR bergantung pada TRANSPORT PTY: kalau byte SGR
665
814
  tak sampai ke stdin anak, selection → OSC52 tak bisa diverifikasi lewat
666
815
  byte stream nyata. Pada lingkungan diagnostik Windows (ConPTY + node-pty
@@ -682,8 +831,13 @@ panjang).
682
831
  > [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
683
832
  > dipoles dengan mengganti kata-kata.
684
833
 
834
+ - `test/output-window.test.ts` — I36 (judul/body/hint, scroll ↓/`j`/`k`/wheel +
835
+ counter posisi di judul, sembunyikan hint scroll bila pas 1 layar, salin isi
836
+ dengan `c` lewat `onCopy`, Esc menutup, non-TTY fallback false, lebar outputWindowWidth).
685
837
  - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (baris indikator dipotong ke
686
- lebar frame walau locale id 51 kolom; prompt idle bertahan setelah Esc;
838
+ lebar frame walau locale id 51 kolom; zero-state welcome saat boot kosong;
839
+ `Tab` autolengkap dropdown `/` vs putar WorkMode saat menu tertutup; klik pada
840
+ baris composer kedua hasil wrap; prompt idle bertahan setelah Esc;
687
841
  `repaint()` tak melukis saat suspended; boot/exit pairing, transcript
688
842
  viewport, mouse-wheel/drag-selection/PgUp/PgDn scroll + indikator, prompt
689
843
  editing, dots/timer, status bar, Esc-only abort, quit, suspend/resume,
@@ -693,10 +847,19 @@ panjang).
693
847
  `test/tui-transcript.test.ts` + `test/presentation-projections.test.ts`;
694
848
  P0: jalur error TUI meredaksi credential — sentinel bearer tak pernah tampil
695
849
  di layar).
696
- - `test/prompt-engine.test.ts` — decoder streaming CSI/SGR/X10: wheel menjadi key scroll, klik mouse tidak masuk teks.
850
+ - `test/prompt-engine.test.ts` — decoder streaming CSI/SGR/X10 (`Alt+Enter`,
851
+ CSI-u `Shift+Enter`, `modifyOtherKeys` → `ctrl-j`, batas payload bracketed
852
+ paste 512 KiB, `Tab` complete di menu terbuka), wheel menjadi key scroll,
853
+ klik mouse tidak masuk teks.
697
854
  - `test/errors-usage.test.ts` — format error UI: `formatError` (kanonik untuk TUI/wizard/one-shot) meredaksi credential (bearer, kunci provider, query, token di batas potong 150 kolom), membuang escape ANSI, memetakan kategori/kind provider, dan menjaga pesan biasa tetap informatif.
698
855
  - `test/checkpoint-lifecycle.test.ts` — checkpoint = milik lifecycle sesi: manifest tersedia saat `close()` kembali (barrier), tak ada operasi yang tertinggal, kegagalan checkpoint tercatat + dilaporkan tanpa unhandled rejection, dan semua operasi dari beberapa turn selesai saat drain.
699
- - `test/tui-transcript.test.ts` — projection source-mapped: wrap, CJK/ANSI, user prefix, tabel TSV, selection text, cap buffer live, dan render markdown inline jawaban model (heading/bold/code; delimiter fence disembunyikan, isi fence dan gema user tetap literal).
856
+ - `test/tui-transcript.test.ts` — projection source-mapped: wrap, CJK/ANSI, user
857
+ prefix & jeda antar-turn, akurasi `displayStart`/`pointAt`/`columnAtOffset`
858
+ pada baris user dan markdown inline, tabel TSV, selection text (termasuk border
859
+ ASCII `+---+` yang tidak boleh terseleksi), cap buffer live, dan render
860
+ markdown inline jawaban model (heading/bold/code; tag bahasa fence redup
861
+ ketika berbahasa, delimiter fence disembunyikan, isi fence dan gema user tetap
862
+ literal).
700
863
  - `test/screen-buffer.test.ts` — parser frame harness (unit).
701
864
  - `test/tui-transcript.test.ts` — I7/I12/I17/I22 (ledger satu baris per tool, cap 5000 + marker evict, `total()` monotonik kebal evict, viewport, thinking minimized/expanded).
702
865
  - `test/thinking-area.test.ts` — I22 area thinking: blok live maks 10 baris (header/`… N baris lagi`), ringkasan 1 baris + detail `/expand` saat turn selesai, tanpa duplikasi, dan fallback legacy saat panel OFF.
@@ -738,12 +901,23 @@ panjang).
738
901
  pola mati dihapus, subset p15..p24 hadir di kedua job.
739
902
 
740
903
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
741
- anti-hantu) + I13 (App.paintRegion/clearRegion mendelegasikan region modal ke
742
- screen; clock badge memutar `◷` saat idle lalu berhenti saat quit).
904
+ anti-hantu, `NO_COLOR=1` resume recovery, wheel pada dropdown `/` terbuka
905
+ menggeser menu tanpa menggulir transkrip) + I13 (App.paintRegion/clearRegion
906
+ mendelegasikan region modal ke screen; clock badge memutar `◷` saat idle lalu
907
+ berhenti saat quit).
743
908
  - `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
744
909
  Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
745
910
  select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
746
- lama; field aktif di luar tinggi kotak tetap terlihat).
911
+ lama; field aktif di luar tinggi kotak tetap terlihat; stack label panjang di
912
+ atas input & sanitasi kontrol C1; adaptasi lebar dinamis saat resize) + I25
913
+ v7.16 (footer dinamis tanpa placeholder `{move}/{save}/{cancel}`; select
914
+ menampilkan hint panah).
915
+ - `test/hint-grammar.test.ts` — I25 v7.16 (grammar `kunci label kunci label`
916
+ tanpa `·`/titik dua; label id/en; `listRow` memakai kolom marker tetap).
917
+ ASCII fallback getter panah/chevron/caret dikunci inventory glyph di
918
+ `test/cli-help-language.test.ts`.
919
+ - `test/theme-levels.test.ts` — I6/UI-RENDER (palet 16-warna memakai SGR 16,
920
+ 256-warna `38;5`, truecolor `38;2`; mono identitas).
747
921
  - `test/render-audit-2026-11.test.ts` — audit renderer 2026-11-12 (proyeksi
748
922
  pending dimemo per baris → tidak O(n²); SGR majemuk diproses berurutan di
749
923
  `truncateToWidth`; indentasi `wordWrap`; SGR opak di highlight; cap input &
@@ -757,9 +931,12 @@ panjang).
757
931
  `sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
758
932
  sekadar di-import tidak menulis byte ke alt-screen.
759
933
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
760
- stdout-pipe tanpa sink = deny) + modal v0.24 (kotak dilukis via
761
- `paintRegion`, `clearRegion` dipanggil saat selesai, input raw-mode di-echo
762
- ke kotak, Esc/Ctrl+C = batal fail-closed).
934
+ stdout-pipe tanpa sink = deny; echo memakai `glyphs.arrow` termasuk
935
+ `MINICODE_ASCII=1`) + modal v0.24 (kotak dilukis via `paintRegion`,
936
+ `clearRegion` dipanggil saat selesai, input raw-mode di-echo ke kotak,
937
+ Esc/Ctrl+C = batal fail-closed) + I25 v7.16 (kursor diparkir di opsi aktif,
938
+ quick-key tanpa opsi diabaikan, hint ask_user Enter/Esc, resize dinamis,
939
+ wheel pilihan, dan guard layar sempit `<10` baris).
763
940
  - `test/background-job-badge.test.ts` — I13 (badge `◷ N` = jumlah job hidup,
764
941
  fase berputar dari clock idle, `[BG:n]` fallback ASCII, nol byte saat 0) +
765
942
  `onBackgroundJobFinished` emit TEPAT SEKALI per job (error+close tidak dobel).
@@ -831,8 +1008,10 @@ panjang).
831
1008
  - `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
832
1009
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
833
1010
  - `test/cli-commands.test.ts` — /status cetak, /sessions popup.
834
- - `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
835
- mencoba memulihkan alt-screen dan reset region) + I1 (satu `write` per frame;
1011
+ - `test/screen.test.ts` — I16 (pairing + paintRegion + pemulihan backdrop redup
1012
+ tanpa `2J` saat menyusut/tutup/resize + `regionEpoch` memaksa repaint penuh
1013
+ pada handle induk saat `NO_COLOR=1`; open/paint writer failure mencoba
1014
+ memulihkan alt-screen dan reset region) + I1 (satu `write` per frame;
836
1015
  repaint penuh saat frame pertama / drift stderr / perubahan kolom, dan diff
837
1016
  inkremental per sel pada paint berikutnya yang setara — bukan clear `ESC[2J`
838
1017
  tiap keystroke).
@@ -849,8 +1028,11 @@ panjang).
849
1028
  yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
850
1029
  - `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
851
1030
  diagnostik stderr, stdout kosong, exit 1, provider tidak dipanggil).
852
- - `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box).
853
- - `test/tui-overlay.test.ts` — I11/I16 (popup region + gate layar).
1031
+ - `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box, `canRenderModal`,
1032
+ footer ber-SGR tak di-dim ganda).
1033
+ - `test/tui-overlay.test.ts` — I11/I16 (popup region, gate layar, resize
1034
+ dinamis `picker`, serta sharing `screen` agar picker nested membersihkan
1035
+ kotak induk tanpa tearing).
854
1036
  - `test/ui-boundary.test.ts` — I1/I3 (src/ui tak impor keluar).
855
1037
  - `test/i18n.test.ts` — I26 (resolusi, fallback, interpolasi, kelengkapan;
856
1038
  LC_ALL > LANG, string kosong diabaikan).
@@ -858,8 +1040,11 @@ panjang).
858
1040
  Indonesia di luar kamus; kontrol positif id.ts kena, negatif en.ts bersih).
859
1041
  - `test/tui-lang.test.ts` — I26 (locale sesi `/lang` end-to-end + persisten;
860
1042
  nilai tak dikenal ditolak) + I24 (`/help` satu sumber; `/copy 2` menyalin dua
861
- turn terakhir).
862
- - `test/cli-help-language.test.ts` — I26/I25 (label en, kelengkapan /help).
1043
+ turn terakhir) + I36 (`/help` dan `/status` tampil di jendela output command;
1044
+ setelah ditutup, readout TIDAK bocor ke transkrip).
1045
+ - `test/cli-help-language.test.ts` — I26/I25 (label en, kelengkapan /help;
1046
+ v7.16: grup View terisi di full help — compact/thinking/expand/minimize/fold
1047
+ terdaftar, bukan heading kosong).
863
1048
  - `test/tui-geometry.test.ts` — I20/I25 (lebar tetap per permukaan, step
864
1049
  wizard, form error).
865
1050
  - `test/sanitize.test.ts` — I2 (C1/bidi/tag dibuang, ZWJ dipertahankan;
@@ -96,7 +96,15 @@ renderer ini.
96
96
  Tahap I — view murni vs controller: `src/ui/screens/` (props + callback,
97
97
  tanpa IO) digerakkan `cli/` (`tui.ts`, `commands.ts`, `wizard.ts`,
98
98
  `model-manager.ts`, `provider-manager.ts`, `src/ui/approval/prompt.ts` via DI `ask`,
99
- `setupWhenEmpty`, `setSubAgentSessionFactory`).
99
+ `setupWhenEmpty`, `setSubAgentSessionFactory`). Readout command (`/help`,
100
+ `/status`, `/context`, `/history`, `/expand`, `/sync`, `/scheduler`) dirender
101
+ `output-window.ts` sebagai jendela ber-scroll di atas chat (v7.18–v7.19, reflow saat
102
+ resize, counter judul, scroll wheel/`j`/`k`/`Space`, dan salin `c` opsional); jendela
103
+ interaktif command (`/model`, `/provider`, `/sessions`, picker) berbagi
104
+ `dialogBox`/`hintLine` (dan `listRow` untuk daftar) yang sama serta mendukung scroll mouse
105
+ wheel. TUI fullscreen menampilkan zero-state welcome ringkas saat transkrip kosong/idle,
106
+ `Tab` pada dropdown `/` untuk autocomplete, jeda antar-turn dan label bahasa fence redup,
107
+ serta fallback glyph `MINICODE_ASCII=1` konsisten hingga garis tabel dan ellipsis.
100
108
 
101
109
  ## 2. Kontrak Event → UI
102
110
 
package/docs/agents.md CHANGED
@@ -5,14 +5,14 @@
5
5
 
6
6
  Sub-agent = instans agent dengan **context terpisah** dari parent: memory, signal, dan budget sendiri. Pool concurrency 3 — maksimum 3 sub-agent hidup sekaligus — dan abort-aware (mewarisi AbortSignal parent; parent batal → anak berhenti).
7
7
 
8
- `delegate_task` meminta persetujuan di **ASK** (TTY); non-TTY menolak. Di **AUTO**, delegasi berjalan tanpa prompt jika capability telah diotorisasi. Anak mewarisi WorkMode parent; `DISCUSS`/`PLAN` membatasi tool anak ke subset eksplorasi baca-saja. **Satu approval di ASK hanya mencakup satu delegasi.**
8
+ `delegate_task` meminta persetujuan di **ASK** (TTY); non-TTY menolak. Di **AUTO**, delegasi berjalan tanpa prompt jika capability telah diotorisasi. Anak mewarisi WorkMode parent; `DISCUSS` membatasi tool anak ke subset eksplorasi baca-saja. **Satu approval di ASK hanya mencakup satu delegasi.**
9
9
 
10
10
  ## Mode anak: `explore` / `plan`
11
11
 
12
12
  | Mode anak | Kemampuan |
13
13
  |---|---|
14
14
  | `explore` | Subset tool eksplorasi baca-saja untuk mencari dan memahami kode |
15
- | `plan` | Tidak mendapat `todo_write`, mutasi memory, commit, nesting, atau job background. Parent PermissionMode `ASK`, `plan`, atau `readonly` memaksa mode anak menjadi `explore`. WorkMode parent `DISCUSS`/`PLAN` juga membatasi daftar tool anak ke subset eksplorasi; pada `BUILD`, mode `plan` dapat memakai tool dasar yang tersedia, tetap tunduk pada PermissionMode anak |
15
+ | `plan` | Tidak mendapat `todo_write`, mutasi memory, commit, nesting, atau job background. Parent PermissionMode `ASK`, `plan`, atau `readonly` memaksa mode anak menjadi `explore`. WorkMode parent `DISCUSS` juga membatasi daftar tool anak ke subset eksplorasi; pada `BUILD`, mode `plan` dapat memakai tool dasar yang tersedia, tetap tunduk pada PermissionMode anak |
16
16
 
17
17
  Restriksi anak yang **selalu** berlaku: `delegate_task`, `git_commit`, memory/todo writes, `submit_result`, `bash_output`, dan `bash_kill` tidak tersedia. Background shell ditolak agar tidak membuat job yatim. Daftar tool dinamis MCP tidak diteruskan ke anak. WorkMode `BUILD` adalah label produk untuk identitas runtime `EXECUTE`.
18
18
 
@@ -126,17 +126,17 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
126
126
 
127
127
  Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard vs bar loading) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. Bar loading startup (`src/ui/runtime/loading-bar.ts`) adalah painter transient jenis kedua: single-line blok `▓░` + persen + label, digambar ulang hanya saat `update(label, percent)` dipanggil, TTY-only (non-TTY = no-op nol byte), label disanitasi. Diagnostik fase startup (identity/writer/resume/recovery/context) didefer saat REPL ke `ctx.startupNotices` dan di-flush ke transcript TUI; non-interaktif tetap mencetak langsung. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `loading-bar`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
128
128
 
129
- Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Discuss model cwd … context Auto ●` — nilai mode saja, label produk `Work Mode:`/`Permission Mode:` dihapus v0.24; titik `●` kuning=allow-list aktif, abu=nonaktif, `○` merah=unrestricted, badge `◷ N` bila job background hidup) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
129
+ Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Discuss model cwd … context Auto ●` — nilai mode saja, label produk `Work Mode:`/`Permission Mode:` dihapus v0.24; titik `●` kuning=allow-list aktif, abu=nonaktif, `○` merah=unrestricted, badge `◷ N` bila job background hidup) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
130
130
 
131
131
  ## Modul kunci
132
132
 
133
133
  - `src/session/verification.ts` + `src/tools/evidence.ts`: identitas invokasi milik aplikasi, intent/receipt yang di-await, observasi eksplisit, idempotency, dan korelasi efek anak — semuanya di jurnal mutasi yang sama.
134
134
 
135
- - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `ledger.ts` (status word/glyph/paint + run-marker bersama untuk TUI & linear), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `cells.ts` (framebuffer sel grapheme+SGR + diff "tulis-ulang ekor" untuk penulisan inkremental), `composer-wrap.ts` (wrap composer inkremental), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
135
+ - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`, palet level-aware 16/256/truecolor), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `ledger.ts` (status word/glyph/paint + run-marker bersama untuk TUI & linear), `hint.ts` (grammar hint `kunci label` spasi-only), `list.ts` (`listRow` marker `›` + kolom tetap), `notice.ts` (notice sukses/error/info), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `cells.ts` (framebuffer sel grapheme+SGR + diff "tulis-ulang ekor" untuk penulisan inkremental), `composer-wrap.ts` (wrap composer inkremental), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
136
136
  - `src/presentation/`: `events.ts` mendefinisikan event presentasi dan registry durability; `adapter.ts` memetakan runtime ke `DomainEvent`; `reducer.ts`/`model.ts` membangun state replayable dan ringkasan turunan; `store.ts` menyimpan referensi konten; `projection.ts` membentuk envelope `minicode.output.v1` dan kategori error machine. `src/session/persistence.ts` menyimpan log `presentation_events` dan `messages` dengan fidelity `reasoning`/`is_error`. `cli/setup.ts` memiliki bridge exhaustive `toPresentationEvent()`; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy`.
137
137
  - `src/policy/`: `context.ts` (estimator sadar-densitas kode/JSON + kalibrasi usage), `context-window.ts` + `context-window-catalog.ts` (resolve window: config → katalog → models.dev → default 128K alias → 32K), `bpe.ts` + `tokenizer-registry.ts` (tokenizer BPE presisi on-demand dari HuggingFace, cache lokal, fallback densitas), `compaction.ts` (kompaksi LLM + mekanikal, anti-drift/anti-thrash, prefer provider sesi), `usage.ts`/`pricing.ts` (estimas biaya + models.dev).
138
138
  - `src/ui/input/`: `askLine`, `prompt-engine` (grapheme `Intl.Segmenter`, streaming decoder, bracket-paste, mouse X10/SGR press/drag/release + wheel dinormalisasi; selection app-level di TUI).
139
- - `src/ui/screens/`: view murni `picker/wizard/model-manager/provider-manager`.
139
+ - `src/ui/screens/`: view murni `picker/wizard/model-manager/provider-manager/form/dialog/output-window`; `output-window.ts` = jendela readout command ber-scroll di atas chat (v7.18).
140
140
  - `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
141
141
  - `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
142
142
  - `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
@@ -2,7 +2,7 @@
2
2
 
3
3
  Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
4
4
 
5
- 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/perencanaan), `BUILD` (implementasi).
5
+ 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi & perencanaan read-only) atau `BUILD` (implementasi).
6
6
  2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
7
7
  3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
8
8
 
@@ -12,22 +12,20 @@ Hard security (path jail luar workspace, sensitive-file, owned-state, bash-guard
12
12
 
13
13
  | Saya ingin… | Gunakan | Karena |
14
14
  |---|---|---|
15
- | Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal; network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
15
+ | Memahami repo / merencanakan tanpa mutasi | `--work-mode DISCUSS` | Ceiling read-only lokal + artefak rencana; tulis workspace/git/delegasi eksekusi ditolak di gerbang |
16
16
  | Minta agen membuat perubahan | `--work-mode BUILD` + `AUTO` (Permission Mode default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
17
17
  | Menyetujui setiap perubahan | `--work-mode BUILD --ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
18
- | Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
19
18
  | Otomasi/CI tanpa manusia | One-shot/`exec` + default `DISCUSS` untuk baca; tambah `--work-mode BUILD` bila perlu mutasi | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
20
19
  | Otonom penuh di mesin sendiri | `--work-mode BUILD` + `AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
21
20
  | Full akses tanpa pembatas (VM/VPN tepercaya) | `/unrestric` (perintah TUI tersembunyi, per-sesi) | Melepas jail path luar workspace + bash-guard + allowlist/sandbox; kredensial git sempit (`GH_TOKEN`/`GITHUB_TOKEN`/`SSH_AUTH_SOCK`) diteruskan hanya di mode ini; file sensitif dan state minicode tetap ditolak; footer menampilkan `○` merah |
22
21
 
23
22
  ## Rule of thumb
24
23
 
25
- 1. **Sesi baru mulai `DISCUSS`+`AUTO`** untuk membatasi aksi awal; pilih `BUILD` secara eksplisit saat ingin implementasi. `AUTO` mengatur persetujuan dan tidak memberi capability dengan sendirinya.
26
- 2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
27
- 3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
28
- 4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
29
- 5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
30
- 6. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — model bisa menyentuh file apa pun di host (kecuali file sensitif/state minicode), menjalankan shell tanpa allow-list, dan `git_push` ke remote. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
24
+ 1. **Sesi baru mulai `DISCUSS`+`AUTO`** untuk investigasi/perencanaan read-only tanpa menyentuh file/git; pilih `BUILD` secara eksplisit saat ingin implementasi. `AUTO` mengatur persetujuan dan tidak memberi capability dengan sendirinya.
25
+ 2. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
26
+ 3. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
27
+ 4. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
28
+ 5. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — model bisa menyentuh file apa pun di host (kecuali file sensitif/state minicode), menjalankan shell tanpa allow-list, dan `git_push` ke remote. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
31
29
 
32
30
  ## Tradeoff yang jujur
33
31