minicode-ai 0.23.0 → 0.25.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 (75) hide show
  1. package/README.md +2 -2
  2. package/cli/tui.ts +28 -2
  3. package/docs/README.md +2 -2
  4. package/docs/SUMMARY.md +10 -19
  5. package/docs/TERMINAL_CONTRACT.md +82 -28
  6. package/docs/architecture.md +1 -1
  7. package/docs/autonomous-scheduler.md +283 -2
  8. package/docs/choosing-mode.md +4 -4
  9. package/docs/concepts.md +39 -3
  10. package/docs/config.md +90 -4
  11. package/docs/environment.md +3 -0
  12. package/docs/getting-started.md +58 -2
  13. package/docs/repl.md +1 -1
  14. package/docs/security.md +49 -2
  15. package/docs/tools.md +2 -1
  16. package/package.json +2 -36
  17. package/src/app/provider-layer.ts +1 -1
  18. package/src/config.ts +2 -0
  19. package/src/constants.ts +3 -0
  20. package/src/lib/safe-open.ts +21 -12
  21. package/src/memory/vector.ts +0 -31
  22. package/src/policy/context-window.ts +0 -33
  23. package/src/policy/no-progress.ts +1 -1
  24. package/src/policy/permission.ts +5 -0
  25. package/src/policy/scrub.ts +15 -2
  26. package/src/policy/tool-contract.ts +11 -9
  27. package/src/presentation/reducer.ts +1 -0
  28. package/src/providers/anthropic.ts +3 -3
  29. package/src/providers/detect.ts +27 -0
  30. package/src/providers/provision.ts +15 -1
  31. package/src/task/autonomous-policy.ts +7 -0
  32. package/src/task/graph-validate.ts +1 -1
  33. package/src/task/session-authority.ts +0 -5
  34. package/src/task/store.ts +0 -4
  35. package/src/tools/ask_user.ts +14 -1
  36. package/src/tools/bash.ts +57 -9
  37. package/src/tools/context.ts +10 -0
  38. package/src/tools/delete_file.ts +3 -2
  39. package/src/tools/edit.ts +5 -4
  40. package/src/tools/git.ts +70 -12
  41. package/src/tools/glob.ts +13 -5
  42. package/src/tools/grep.ts +26 -10
  43. package/src/tools/index.ts +3 -2
  44. package/src/tools/lsp.ts +15 -9
  45. package/src/tools/move_file.ts +4 -3
  46. package/src/tools/patch.ts +5 -4
  47. package/src/tools/read_file.ts +3 -2
  48. package/src/tools/read_image.ts +3 -2
  49. package/src/tools/task.ts +1 -0
  50. package/src/tools/todo.ts +4 -8
  51. package/src/tools/write_file.ts +4 -3
  52. package/src/ui/approval/prompt.ts +226 -77
  53. package/src/ui/footer.ts +41 -29
  54. package/src/ui/i18n/en.ts +4 -0
  55. package/src/ui/i18n/id.ts +4 -0
  56. package/src/ui/render/activity-group.ts +1 -0
  57. package/src/ui/render/ledger.ts +1 -9
  58. package/src/ui/render/logo.ts +0 -5
  59. package/src/ui/render/markdown-table.ts +0 -3
  60. package/src/ui/render/table-grid.ts +0 -3
  61. package/src/ui/render/theme.ts +31 -5
  62. package/src/ui/runtime/screen.ts +7 -1
  63. package/src/ui/screens/dialog.ts +45 -81
  64. package/src/ui/screens/form.ts +10 -10
  65. package/src/ui/screens/model-manager.ts +7 -10
  66. package/src/ui/screens/picker.ts +8 -11
  67. package/src/ui/screens/provider-manager.ts +9 -13
  68. package/src/ui/tui/app.ts +92 -9
  69. package/src/ui/tui/transcript.ts +4 -0
  70. package/docs/P14_OPEN_WORK.md +0 -290
  71. package/docs/config-providers.md +0 -87
  72. package/docs/glossary.md +0 -39
  73. package/docs/quickstart.md +0 -60
  74. package/docs/security-model.md +0 -96
  75. package/docs/terminal.md +0 -91
package/README.md CHANGED
@@ -39,9 +39,9 @@ WorkMode controls how the agent works (`DISCUSS`, `PLAN`, or `BUILD`); permissio
39
39
  The full manual lives in [`docs/`](docs/) and is rendered at [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). Quick links:
40
40
 
41
41
  - [Documentation index](docs/README.md) and [full navigation](docs/SUMMARY.md)
42
- - [Installation](docs/getting-started.md) · [Quickstart](docs/quickstart.md) · [CLI](docs/cli.md) · [TUI](docs/repl.md)
42
+ - [Installation](docs/getting-started.md) · [Quickstart](docs/getting-started.md) · [CLI](docs/cli.md) · [TUI](docs/repl.md)
43
43
  - [Configuration and providers](docs/config.md) · [Environment variables](docs/environment.md) · [Tools](docs/tools.md)
44
- - [Security model](docs/security-model.md) · [Policy and sandbox](docs/policy-sandbox.md)
44
+ - [Security model](docs/security.md) · [Policy and sandbox](docs/policy-sandbox.md)
45
45
  - [Architecture and repository map](docs/architecture.md)
46
46
  - [Contributing](docs/contributing.md) · [Release history](https://github.com/minilabs-id/minicode/releases)
47
47
 
package/cli/tui.ts CHANGED
@@ -26,6 +26,7 @@ import {
26
26
  } from "../src/presentation/projection.ts"
27
27
  import { redoLastCheckpoint, undoLastCheckpoint } from "../src/session/checkpoint.ts"
28
28
  import { renderSkill } from "../src/skills/loader.ts"
29
+ import { listBackgroundJobs, onBackgroundJobFinished } from "../src/tools/bash.ts"
29
30
  import {
30
31
  clipboardByteLength,
31
32
  MAX_CLIPBOARD_BYTES,
@@ -193,6 +194,9 @@ export async function runTui(ctx: CliSession): Promise<void> {
193
194
  ui.setMinimizeActivity(true)
194
195
  let warned80 = false
195
196
  let abort: AbortController | null = null
197
+ /** Job background hidup (badge footer). Dihitung dari registry tool bash. */
198
+ const countLiveBackgroundJobs = (): number =>
199
+ listBackgroundJobs().reduce((n, j) => (j.done ? n : n + 1), 0)
196
200
 
197
201
  // Fase 1 perf (butir 2b): `session.contextTokens` adalah getter O(history)
198
202
  // (estimateMessages mengiterasi SELURUH store + estimator per pesan). Footer
@@ -629,7 +633,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
629
633
  // WorkMode EXECUTE (BUILD) agar ceiling DISCUSS/PLAN tak menahan tulis.
630
634
  workModeControl?.setWorkMode("EXECUTE")
631
635
  app.repaint()
632
- transcript.pushInfo([c.warning(`${glyphs.unlock} ${t("tui.unrestrictedOn")}`)])
636
+ transcript.pushInfo([c.warning(`${c.red(glyphs.unlock)} ${t("tui.unrestrictedOn")}`)])
633
637
  return
634
638
  }
635
639
  mode = modeBeforeUnrestricted ?? "auto"
@@ -643,7 +647,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
643
647
  modeBeforeUnrestricted = null
644
648
  workModeBeforeUnrestricted = null
645
649
  app.repaint()
646
- transcript.pushInfo([c.muted(`${glyphs.unlock} ${t("tui.unrestrictedOff", { m: mode })}`)])
650
+ transcript.pushInfo([c.muted(`${glyphs.lock} ${t("tui.unrestrictedOff", { m: mode })}`)])
647
651
  return
648
652
  }
649
653
  if (name === "lang") {
@@ -812,6 +816,9 @@ export async function runTui(ctx: CliSession): Promise<void> {
812
816
  cwd: cwd ?? process.cwd(),
813
817
  context: fmtCtx(getContextTokens()),
814
818
  metrics: fmtUsageMetrics(ctx, getContextTokens()),
819
+ // Jumlah job background hidup — dihitung di sini karena badge footer
820
+ // adalah view murni (src/ui dilarang impor src/ non-UI).
821
+ backgroundJobs: countLiveBackgroundJobs(),
815
822
  },
816
823
  busy,
817
824
  }
@@ -853,12 +860,30 @@ export async function runTui(ctx: CliSession): Promise<void> {
853
860
  // Approval sebagai warga TUI: blok pertanyaan + keputusan tercatat di
854
861
  // transkrip dan terlihat sebelum menjawab (tanpa sink = tulis langsung).
855
862
  const { setApprovalSink } = await import("../src/ui/tui/transcript.ts")
863
+ // Auto-resume sekali per job background (scope "lanjutkan tanpa saya"),
864
+ // bounded: satu resume per id, tak menumpuk walau banyak job selesai.
865
+ const resumedJobs = new Set<string>()
866
+ const autoResumeEnabled = process.env.MINICODE_AUTORESUME_BG !== "0"
867
+ const unsubscribeJobFinished = onBackgroundJobFinished((id, code) => {
868
+ try {
869
+ if (resumedJobs.has(id)) return
870
+ resumedJobs.add(id)
871
+ app.repaint()
872
+ if (!autoResumeEnabled) return
873
+ // Abort-aware: jangan menyela turn berjalan atau memulai saat quitting.
874
+ transcript.pushInfo([c.muted(t("tui.bgFinished", { id, code: code ?? "?" }))])
875
+ if (abort !== null) return
876
+ void runTurn(t("tui.bgFinishedAuto", { id, code: code ?? "?" })).catch(() => {})
877
+ } catch {}
878
+ })
856
879
  try {
857
880
  setApprovalSink({
858
881
  pushBlock: (lines) => transcript.pushInfo(lines),
859
882
  repaint: () => app.repaint(),
860
883
  suspend: () => app.suspend(),
861
884
  resume: () => app.resume(),
885
+ paintRegion: (lines, topRow) => app.paintRegion(lines, topRow),
886
+ clearRegion: () => app.clearRegion(),
862
887
  })
863
888
  const res = await app.run()
864
889
  if (!res.started) {
@@ -874,6 +899,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
874
899
  }
875
900
  } finally {
876
901
  setApprovalSink(null)
902
+ unsubscribeJobFinished()
877
903
  for (const unsub of liveContextUnsubs.splice(0)) {
878
904
  try {
879
905
  unsub()
package/docs/README.md CHANGED
@@ -5,7 +5,7 @@ MiniCode adalah coding agent terminal yang dibangun di atas kernel MiniCore. Jal
5
5
  ## Mulai
6
6
 
7
7
  1. Ikuti [instalasi](getting-started.md). Metadata paket dan batas runtime Bun tersedia di `package.json` pada root repository.
8
- 2. Gunakan [quickstart](quickstart.md) untuk menyiapkan provider dan menjalankan prompt pertama.
8
+ 2. Gunakan [quickstart](getting-started.md) untuk menyiapkan provider dan menjalankan prompt pertama.
9
9
  3. Baca [memilih mode](choosing-mode.md) sebelum memberi agent akses tulis atau eksekusi.
10
10
 
11
11
  ## Batas yang perlu diketahui
@@ -16,7 +16,7 @@ MiniCode adalah coding agent terminal yang dibangun di atas kernel MiniCore. Jal
16
16
 
17
17
  ## Peta dokumentasi
18
18
 
19
- `SUMMARY.md` adalah daftar navigasi; dibaca build minilabs untuk membangun indeks halaman. Versi terbit tersedia di [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). [Arsitektur](architecture.md) memuat peta struktur dan alur runtime.
19
+ `SUMMARY.md` adalah daftar navigasi; dibaca build minilabs untuk membangun indeks halaman. Jumlah halaman dijaga kecil dan bebas duplikasi — satu topik, satu halaman. Versi terbit tersedia di [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). [Arsitektur](architecture.md) memuat peta struktur dan alur runtime.
20
20
 
21
21
  ## Pengembangan
22
22
 
package/docs/SUMMARY.md CHANGED
@@ -4,11 +4,9 @@
4
4
 
5
5
  ## Memulai
6
6
 
7
- * [Instalasi](getting-started.md)
8
- * [Quickstart 5 menit](quickstart.md)
9
- * [Konsep & Desain](concepts.md)
7
+ * [Instalasi & Quickstart](getting-started.md)
8
+ * [Konsep, Desain & Glosarium](concepts.md)
10
9
  * [Memilih Mode](choosing-mode.md)
11
- * [Glosarium](glossary.md)
12
10
 
13
11
  ## Menggunakan
14
12
 
@@ -18,7 +16,7 @@
18
16
  * [Skills & Hooks](skills.md)
19
17
  * [Pricing & Budget](pricing-budget.md)
20
18
 
21
- ## Kemampuan (tools & integrasi)
19
+ ## Kemampuan
22
20
 
23
21
  * [Tools](tools.md)
24
22
  * [Sub-Agents & Tasks](agents.md)
@@ -26,8 +24,7 @@
26
24
 
27
25
  ## Konfigurasi
28
26
 
29
- * [Config — File & Lokasi Data](config.md)
30
- * [Config & Provider](config-providers.md)
27
+ * [Config & Provider](config.md)
31
28
  * [Environment Variables](environment.md)
32
29
 
33
30
  ## State & Memori
@@ -37,31 +34,25 @@
37
34
 
38
35
  ## Keamanan
39
36
 
40
- * [Security Model](security-model.md) — ancaman & trust boundary
41
- * [Policy & Sandbox](policy-sandbox.md) — mode, guard, sandbox
42
- * [Keamanan](security.md) — mekanisme & bukti pengukuran
43
-
44
- ## Bantuan
45
-
46
- * [Troubleshooting](troubleshooting.md)
37
+ * [Keamanan — mode ancaman & bukti](security.md)
38
+ * [Policy & Sandbox](policy-sandbox.md)
47
39
 
48
40
  ## Eksperimental
49
41
 
50
- * [Autonomous Scheduler](autonomous-scheduler.md)
51
- * [Open Work — Lintas Sesi](P14_OPEN_WORK.md)
42
+ * [Autonomous Scheduler & Open Work](autonomous-scheduler.md)
52
43
 
53
44
  ## Kontributor & Arsitektur
54
45
 
55
46
  * [Arsitektur & Peta Repository](architecture.md)
56
- * [Kontrak Terminal (ringkas)](terminal.md)
57
47
  * [Contributing](contributing.md)
48
+ * [Troubleshooting](troubleshooting.md)
58
49
 
59
50
  ## Spesifikasi internal (FROZEN — untuk kontributor)
60
51
 
61
- * [Terminal Contract - 35 invariant, v7.12](TERMINAL_CONTRACT.md)
52
+ * [Terminal Contract](TERMINAL_CONTRACT.md)
62
53
  * [Output Event Model](OUTPUT_EVENT_MODEL.md)
63
54
  * [Output Protocol Spec](OUTPUT_PROTOCOL_SPEC.md)
64
55
  * [Output Rendering Spec](OUTPUT_RENDERING_SPEC.md)
65
56
  * [Output UX Rules](OUTPUT_UX_RULES.md)
66
57
  * [Control Plane Map](CONTROL-PLANE-MAP.md)
67
- * [UI Render Pipeline](UI_RENDER_PIPELINE.md)
58
+ * [UI Render Pipeline](UI_RENDER_PIPELINE.md)
@@ -1,4 +1,35 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.13, 2026-11-13)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.14, 2026-11-14)
2
+
3
+ Perubahan v7.14: **geometri & dekorasi popup diseragamkan** (audit Surface
4
+ Popup, `AUD-001..AUD-011`). Empat perubahan tampak-pengguna:
5
+
6
+ 1. **Lebar kotak popup diskalakan, bukan angka tetap.** `popupBoxWidth(cols) =
7
+ min(max(40, min(88, floor(cols*0.6))), cols-4)` — dihitung saat *mount* lalu
8
+ **dibekukan** (min=max) agar geometri stabil, tetapi menyesuaikan terminal
9
+ tiap mount. I20 diperbarui. Margin 4 kolom **selalu menang** atas lantai
10
+ 40 (AUD-011).
11
+ 2. **Sudut kotak MELENGKUNG (`╭ ╮ ╰ ╯`) default.** Kill-switch:
12
+ `MINICODE_BOX=square` (`┌┐└┘`), `MINICODE_BOX=ascii`/`MINICODE_ASCII=1`
13
+ (`+-|`). Dibaca lazy tiap render.
14
+ 3. **Backdrop popup = scrim tiga tingkat** (`scrimMode()`):
15
+ `bg` = dim **+ latar `48;5;236`** (≥256 warna), `faint` = `\x1b[2m` saja
16
+ (16 warna), `none` = nol byte (mono/non-TTY/`TERM=dumb`). Reset SGR
17
+ dalam konten **memulihkan** scrim; bold **dinetralkan** ke scrim.
18
+ 4. **Kotak approval memakai lebar popup seragam**, bukan selebar layar
19
+ (AUD-007). Opsinya **navigasi daftar**: `↑↓`/`Home`/`End` + `Enter`,
20
+ `Esc` = deny. Ketik-cepat `y`/`a`/`n` (+ sinonim `ya`/`selalu`/`s`/`tidak`/
21
+ `t`) tetap berfungsi — I25 menuntut navigasi daftar, bukan dua langkah wajib.
22
+
23
+ `MINICODE_SCRIM=none` memaksa `faint` untuk diagnostik. Level warna juga
24
+ memakai `process.stdout.getColorDepth()` sesudah env (`COLORTERM`/`TERM`) agar
25
+ Windows Terminal/ConPTY yang tak mengisi `TERM` tetap dapat 256 warna/truecolor
26
+ (AUD-002). Non-TTY **tidak berubah**: 0 warna, 0 scrim, 0 byte (I6).
27
+
28
+ Peta proteksi baru: `test/surface-audit-regressions.test.ts` (AUD-007/008/010/011),
29
+ `test/dialog.test.ts` (glyph melengkung + kill-switch + geometri skala),
30
+ `test/tui-geometry.test.ts` (lebar beku per mount, bukan 64 tetap),
31
+ `test/ui-audit-regressions.test.ts` (AUD-003: bold dinetralkan, `[22m`
32
+ memulihkan scrim — diuji dengan TTY palsu agar `scrimMode() != none`).
2
33
 
3
34
  Perubahan v7.13: baris status kompaksi (`context:compacted`) kini **membedakan
4
35
  hasil** alih-alih mencetak `reason` mentah. Sebelumnya sesi yang konteksnya TIDAK
@@ -36,8 +67,10 @@ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
36
67
  (v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
37
68
 
38
69
  Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
39
- sebagai **ikon gembok** `🔒` di ujung footer (setelah Permission Mode), terang
40
- saat aktif (mode Auto + restrictBash) dan redup saat nonaktif. Sumbu persetujuan
70
+ sebagai **titik monokrom** `●` di ujung footer (setelah Permission Mode), kuning
71
+ saat aktif (mode Auto + restrictBash) dan abu saat nonaktif. Saat mode
72
+ `unrestricted` aktif, titik jadi `○` MERAH (terbuka) sebagai penanda satu-satunya.
73
+ Fallback ASCII `[LOCK]`/`[OPEN]` untuk terminal tanpa UTF-8. Sumbu persetujuan
41
74
  tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
42
75
  sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
43
76
  bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
@@ -57,9 +90,11 @@ command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
57
90
  model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
58
91
  ringkas.
59
92
 
60
- Perubahan v7.7: footer memakai label title case `Work Mode: Build` di sisi kiri
61
- dan `Permission Mode: Auto` di sisi kanan dekat pemakaian konteks. Nilai kedua
62
- mode memakai warna berbeda; pada terminal sempit label dipadatkan sebelum nilai
93
+ Perubahan v7.7 (diperbarui v0.24): footer menampilkan nilai Work Mode di sisi
94
+ kiri dan nilai Permission Mode di sisi kanan dekat pemakaian konteks. Label
95
+ `Work Mode:`/`Permission Mode:` dihapus agar footer satu baris lebih lega —
96
+ pembeda sumbu tinggal warna (Work Mode semantik, Permission Mode cyan). Nilai
97
+ kedua mode memakai title case; pada terminal sempit nilai dipadatkan sebelum
63
98
  mode atau konteks dihilangkan.
64
99
 
65
100
  Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
@@ -295,19 +330,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
295
330
  live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
296
331
  layout paint tidak boleh memproyeksikan transcript dua kali.
297
332
 
298
- 13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
299
- context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
333
+ 13. Status bar: 1 baris dasar (`✦ 00.00.00 Discuss model cwd … context Auto`)
334
+ dari sumber yang sama dengan angka sesi.
300
335
  Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
301
336
  LIVE turn-store yang di-emit kernel per step (event `provider:extension`
302
337
  kind `context-window`, setelah `step:completed`); saat idle kembali ke
303
338
  `session.contextTokens` (committed store). Estimator tetap satu sumber —
304
339
  hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
305
340
  (beku), tak ada duplikasi angka sumber (v7.12).
306
- Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
307
- bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
308
- Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
309
- konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
310
- atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
341
+ Titik `●` mengikuti Permission Mode di ujung kanan: kuning bila bash
342
+ allow-list aktif (restrictBash + mode `Auto`), abu bila tidak; `○` merah
343
+ = mode `unrestricted` (fallback ASCII `[LOCK]`/`[OPEN]`). Work Mode berada
344
+ di kiri; Permission Mode cyan berada di kanan dekat konteks (label produk
345
+ `Work Mode:`/`Permission Mode:` dihapus pada v0.24 — nilai saja). Bila ada
346
+ job background hidup, badge `◷ N` (jam berputar pelan, `N` = jumlah job)
347
+ tampil di samping spark; fallback ASCII `[BG:N]`. `✦` tetap
311
348
  menjadi indikator proses hidup;
312
349
  timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
313
350
  detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
@@ -368,9 +405,18 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
368
405
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
369
406
  oldest-to-newest) melalui OSC 52.
370
407
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
371
- 20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 64,
372
- form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
373
- selalu tampil.
408
+ 20. Lebar kotak popup **diskalakan dari lebar layar dan DIBEKUKAN saat mount**:
409
+ `popupBoxWidth(cols) = min(max(40, min(88, floor(cols*0.6))), cols-4)`
410
+ (v7.14 — dulu angka tetap 64 untuk model/picker/provider/form). Semua
411
+ permukaan popup (picker, model, provider, form, wizard, **approval**) memakai
412
+ fungsi yang SAMA — tak ada permukaan yang memakai lebar layar penuh seperti
413
+ approval sebelum v7.14 (AUD-007). Nilai dihitung sekali per mount lalu
414
+ dikirim sebagai `minWidth == maxWidth` sehingga kotak tak "bernapas" selama
415
+ popup terbuka, tetapi tiap mount menyesuaikan terminal. Margin 4 kolom
416
+ SELALU menang atas lantai 40 (terminal < 44 kolom tidak overflow, AUD-011).
417
+ Sudut kotak MELENGKUNG `╭ ╮ ╰ ╯` secara default; `MINICODE_BOX=square`
418
+ mengembalikan lancip, `MINICODE_BOX=ascii`/`MINICODE_ASCII=1` ke ASCII.
419
+ Nama/ID di depan label; seleksi murni warna; search selalu tampil.
374
420
  21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
375
421
  select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
376
422
  luar kotak. Esc dua-tahap: tekan-1 KEMBALIKAN nilai bawaan field
@@ -526,22 +572,24 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
526
572
  ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
527
573
  `plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
528
574
  PermissionMode AUTO/ASK.
529
- **Footer:** Work Mode tampil di kiri dengan label produk `Work Mode: Build`,
530
- `Work Mode: Plan`, atau `Work Mode: Discuss`; alias internal `EXECUTE` tidak
531
- ditampilkan. Permission Mode tampil di kanan dekat token konteks sebagai
532
- `Permission Mode: Auto` atau `Permission Mode: Ask`. Nilai Work Mode memakai
533
- warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu mudah
534
- dibedakan. Pada terminal sempit label dipadatkan, tetapi kedua nilai mode
535
- dipertahankan selama lebar memungkinkan.
575
+ **Footer:** Work Mode tampil di kiri (nilai `Build`/`Plan`/`Discuss`; alias
576
+ internal `EXECUTE` ditampilkan `Build`). Permission Mode tampil di kanan dekat
577
+ token konteks sebagai nilai `Auto`/`Ask`. Label produk `Work Mode:` dan
578
+ `Permission Mode:` dihapus v0.24 — nilai saja, lebih lega. Nilai Work Mode
579
+ memakai warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu
580
+ mudah dibedakan. Titik `●` kuning = bash allow-list aktif, abu = nonaktif,
581
+ `○` merah = unrestricted. Bila ada job background hidup, badge `◷ N` tampil
582
+ di samping spark.
536
583
 
537
584
  ## Grammar (ringkas)
538
585
 
539
586
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
540
587
  berbingkai di atasnya) ·
541
- status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto 🔒`
588
+ status bar `✦ 00.00.00 Discuss model cwd … context Auto ●`
542
589
  (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
543
590
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
544
- dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
591
+ `Work Mode:`/`Permission Mode:` dihapus; `●` kuning = bash allow-list aktif,
592
+ abu = tidak, `○` merah = unrestricted; badge `◷ N` bila job background hidup)
545
593
  + satu spacer sebelum footer · ledger tool
546
594
  ` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
547
595
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
@@ -659,7 +707,8 @@ panjang).
659
707
  pola mati dihapus, subset p15..p24 hadir di kedua job.
660
708
 
661
709
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
662
- anti-hantu).
710
+ anti-hantu) + I13 (App.paintRegion/clearRegion mendelegasikan region modal ke
711
+ screen; clock badge memutar `◷` saat idle lalu berhenti saat quit).
663
712
  - `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
664
713
  Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
665
714
  select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
@@ -677,8 +726,13 @@ panjang).
677
726
  `sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
678
727
  sekadar di-import tidak menulis byte ke alt-screen.
679
728
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
680
- stdout-pipe tanpa sink = deny).
681
- - `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, ikon gembok 🔒 terang/redup).
729
+ stdout-pipe tanpa sink = deny) + modal v0.24 (kotak dilukis via
730
+ `paintRegion`, `clearRegion` dipanggil saat selesai, input raw-mode di-echo
731
+ ke kotak, Esc/Ctrl+C = batal fail-closed).
732
+ - `test/background-job-badge.test.ts` — I13 (badge `◷ N` = jumlah job hidup,
733
+ fase berputar dari clock idle, `[BG:n]` fallback ASCII, nol byte saat 0) +
734
+ `onBackgroundJobFinished` emit TEPAT SEKALI per job (error+close tidak dobel).
735
+ - `test/footer-render.test.ts` — I13 (nilai mode title case tanpa label produk, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, titik `●` kuning/abu + `○` merah unrestricted, badge `◷ N`/`[BG:N]`).
682
736
  - `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
683
737
  kind `context-window` berisi `usedTokens`/`windowTokens` setelah
684
738
  `step:completed` — sumber live-occupancy footer; nilai > 0 terbukti).
@@ -126,7 +126,7 @@ 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 Work Mode: Discuss model cwd … context Permission Mode: Auto`) 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 (label dipadatkan pada terminal sempit; 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/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.
130
130
 
131
131
  ## Modul kunci
132
132