minicode-ai 0.14.1 → 0.14.4

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 (130) hide show
  1. package/README.md +34 -178
  2. package/cli/args.ts +10 -18
  3. package/cli/auto-update.ts +32 -2
  4. package/cli/commands/acp.ts +20 -27
  5. package/cli/commands/daemon.ts +6 -7
  6. package/cli/commands/exec.ts +12 -10
  7. package/cli/commands.ts +6 -9
  8. package/cli/index.ts +40 -17
  9. package/cli/provider-manager.ts +1 -3
  10. package/cli/setup.ts +174 -145
  11. package/cli/tui.ts +33 -38
  12. package/docs/CONTROL-PLANE-MAP.md +145 -0
  13. package/docs/OUTPUT_EVENT_MODEL.md +1 -1
  14. package/docs/OUTPUT_PROTOCOL_SPEC.md +8 -2
  15. package/docs/OUTPUT_RENDERING_SPEC.md +35 -6
  16. package/docs/OUTPUT_UX_RULES.md +1 -1
  17. package/docs/README.md +14 -102
  18. package/docs/SUMMARY.md +53 -0
  19. package/docs/TERMINAL_CONTRACT.md +136 -77
  20. package/docs/UI_RENDER_PIPELINE.md +204 -0
  21. package/docs/agents.md +5 -5
  22. package/docs/architecture.md +23 -12
  23. package/docs/choosing-mode.md +7 -7
  24. package/docs/cli.md +22 -29
  25. package/docs/concepts.md +1 -1
  26. package/docs/config.md +10 -5
  27. package/docs/contributing.md +6 -6
  28. package/docs/environment.md +3 -1
  29. package/docs/exec.md +5 -5
  30. package/docs/getting-started.md +14 -12
  31. package/docs/glossary.md +9 -7
  32. package/docs/mcp-lsp.md +1 -1
  33. package/docs/memory-sessions.md +7 -5
  34. package/docs/policy-sandbox.md +23 -15
  35. package/docs/quickstart.md +2 -2
  36. package/docs/repl.md +4 -3
  37. package/docs/security-model.md +16 -17
  38. package/docs/security.md +15 -30
  39. package/docs/skills.md +1 -1
  40. package/docs/tools.md +6 -6
  41. package/docs/verify-benchmark.md +16 -0
  42. package/package.json +5 -5
  43. package/scripts/vendor-overlays/minicode-context.patch +109 -0
  44. package/src/app/mentions.ts +4 -3
  45. package/src/app/provider-layer.ts +13 -1
  46. package/src/app/session.ts +229 -22
  47. package/src/app/tool-layer.ts +6 -0
  48. package/src/config.ts +30 -3
  49. package/src/constants.ts +19 -0
  50. package/src/daemon/control.ts +1 -1
  51. package/src/lib/git-hardening.ts +27 -22
  52. package/src/lib/safe-open.ts +73 -19
  53. package/src/lib/trusted-exec.ts +7 -4
  54. package/src/mcp/client.ts +34 -9
  55. package/src/mcp/server.ts +2 -3
  56. package/src/mcp/transport.ts +96 -42
  57. package/src/memory/files.ts +15 -4
  58. package/src/memory/vector.ts +5 -1
  59. package/src/policy/compaction.ts +272 -16
  60. package/src/policy/context-window.ts +73 -0
  61. package/src/policy/context.ts +76 -16
  62. package/src/policy/ratelimit.ts +47 -18
  63. package/src/policy/tool-contract.ts +4 -10
  64. package/src/policy/update-check.ts +83 -6
  65. package/src/policy/usage.ts +31 -14
  66. package/src/policy/work-mode.ts +1 -1
  67. package/src/presentation/adapter.ts +64 -2
  68. package/src/presentation/events.ts +6 -0
  69. package/src/presentation/model.ts +1 -0
  70. package/src/presentation/projection.ts +2 -0
  71. package/src/presentation/reducer.ts +1 -0
  72. package/src/providers/anthropic.ts +52 -19
  73. package/src/providers/guards.ts +158 -16
  74. package/src/providers/provision.ts +12 -3
  75. package/src/providers/responses.ts +61 -23
  76. package/src/providers/router.ts +56 -23
  77. package/src/providers/sse-bounds.ts +170 -0
  78. package/src/repo/repomap.ts +10 -11
  79. package/src/runtime/execution-backend.ts +7 -8
  80. package/src/sandbox/docker.ts +113 -9
  81. package/src/session/checkpoint.ts +9 -2
  82. package/src/session/context-projection.ts +14 -0
  83. package/src/session/context-selector.ts +58 -20
  84. package/src/session/persistence.ts +6 -3
  85. package/src/session/verification.ts +55 -16
  86. package/src/skills/loader.ts +16 -3
  87. package/src/task/model.ts +21 -70
  88. package/src/tools/bash.ts +6 -3
  89. package/src/tools/code_run.ts +6 -5
  90. package/src/tools/context.ts +8 -0
  91. package/src/tools/delete_file.ts +2 -1
  92. package/src/tools/edit.ts +2 -1
  93. package/src/tools/git.ts +128 -54
  94. package/src/tools/glob.ts +2 -1
  95. package/src/tools/grep.ts +31 -6
  96. package/src/tools/lsp.ts +5 -4
  97. package/src/tools/mcp_call.ts +3 -1
  98. package/src/tools/memory.ts +175 -180
  99. package/src/tools/move_file.ts +2 -1
  100. package/src/tools/patch.ts +2 -1
  101. package/src/tools/read_file.ts +94 -1
  102. package/src/tools/read_image.ts +2 -1
  103. package/src/tools/task.ts +9 -1
  104. package/src/tools/todo.ts +4 -5
  105. package/src/tools/web_fetch.ts +28 -12
  106. package/src/tools/web_search.ts +28 -9
  107. package/src/tools/write_file.ts +2 -1
  108. package/src/ui/assistant/simple.ts +72 -3
  109. package/src/ui/footer.ts +131 -66
  110. package/src/ui/i18n/en.ts +3 -11
  111. package/src/ui/i18n/id.ts +3 -11
  112. package/src/ui/input/input.ts +2 -3
  113. package/src/ui/input/prompt-engine.ts +2 -5
  114. package/src/ui/render/width.ts +107 -79
  115. package/src/ui/runtime/screen.ts +49 -37
  116. package/src/ui/screens/model-manager.ts +3 -10
  117. package/src/ui/screens/picker.ts +23 -40
  118. package/src/ui/screens/provider-manager.ts +12 -33
  119. package/src/ui/screens/wizard.ts +0 -1
  120. package/src/ui/tui/app.ts +265 -211
  121. package/src/ui/tui/transcript.ts +87 -8
  122. package/vendor/minicore/VENDOR.md +9 -5
  123. package/vendor/minicore/src/core/loop.ts +47 -12
  124. package/vendor/minicore/src/core/provider.ts +4 -0
  125. package/vendor/minicore/src/core/session.ts +14 -1
  126. package/CHANGELOG.md +0 -1185
  127. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
  128. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
  129. package/docs/PLAN_UIUX_V6.md +0 -209
  130. package/docs/changelog.md +0 -3
@@ -1,13 +1,38 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.4, 2026-10-20)
2
-
3
- Perubahan v7.4 (P12 S2.2 WorkMode): invarian baru I35 — WorkMode (lapis
4
- intent `DISCUSS`/`PLAN`/`EXECUTE`) sebagai dimensi TERPISAH dari permission
5
- mode. Command `/work-mode <DISCUSS|PLAN|EXECUTE>` (aksi operator eksplisit,
6
- transisi berlaku pada sesi yang sedang berjalan); footer menampilkan
7
- `<WorkMode>·<permission mode>` saat WorkMode ≠ EXECUTE (`PLAN·auto`,
8
- `DISCUSS·auto`, `PLAN·readonly`); `EXECUTE` (default) mempertahankan label
9
- permission mode seperti sebelumnya. Tab/Shift+Tab dan `/mode` TETAP khusus
10
- permission mode. Rincian di I35.
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.9, 2026-11-07)
2
+
3
+ Perubahan v7.9: input command slash tidak ditambahkan sebagai pesan transkrip;
4
+ aksi popup provider/model/sesi dan toggle UI tidak meninggalkan riwayat status
5
+ di transkrip. Output command yang informatif, error, dan hasil prompt model tetap
6
+ tampil. Jawaban model membuang blank line di tepi dan merapatkan jeda berulang
7
+ di luar code fence; isi code fence tetap literal.
8
+
9
+ Perubahan v7.8: sesi baru dan sesi legacy tanpa WorkMode mulai di `Discuss`;
10
+ operator hanya dapat memilih `Discuss`, `Plan`, atau `Build`. Permission Mode
11
+ awal `Auto` dan kontrolnya hanya `Auto`/`Ask`. Dropdown `/` menampilkan nama
12
+ command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
13
+ model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
14
+ ringkas.
15
+
16
+ Perubahan v7.7: footer memakai label title case `Work Mode: Build` di sisi kiri
17
+ dan `Permission Mode: Auto` di sisi kanan dekat pemakaian konteks. Nilai kedua
18
+ mode memakai warna berbeda; pada terminal sempit label dipadatkan sebelum nilai
19
+ mode atau konteks dihilangkan.
20
+
21
+ Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
22
+ `BUILD` untuk identitas runtime `EXECUTE`, footer dua sumbu yang selalu tampil,
23
+ dan pintasan `Tab`/`Shift+Tab` untuk WorkMode/PermissionMode.
24
+
25
+ Perubahan v7.5: kepemilikan frame stdout interaktif diperjelas; cleanup `TuiApp.run()`
26
+ berpasangan melalui `finally`; gap proteksi teardown, startup, spacer, layar kecil,
27
+ dan writer ownership ditutup dengan test app/subprocess/PTY.
28
+
29
+ Perubahan v7.4 (P12 S2.2 WorkMode): invarian I35 — WorkMode runtime
30
+ `DISCUSS`/`PLAN`/`EXECUTE` terpisah dari PermissionMode. Nama produk `BUILD`
31
+ adalah alias input dan label tampilan untuk identitas runtime `EXECUTE`; nilai
32
+ persisten tetap `EXECUTE`. Command `/work-mode <DISCUSS|PLAN|BUILD>` juga
33
+ menerima `EXECUTE` sebagai alias kompatibilitas. Footer menampilkan pasangan
34
+ `<WorkMode>·<PermissionMode>`; defaultnya `BUILD · AUTO`. `Tab` memutar WorkMode,
35
+ sedangkan `Shift+Tab` dan `/mode` mengubah PermissionMode. Rincian di I35.
11
36
 
12
37
  Perubahan v7.3 (P11 Presentation & UX): invarian baru I34 — subcommand `exec`
13
38
  dan `daemon` menerima argv SCOPE dari router (flag global dikenal yang
@@ -61,7 +86,7 @@ proteksi").
61
86
 
62
87
  | Stream | Isi | Catatan |
63
88
  |---|---|---|
64
- | stdout | Output PROGRAM yang bermakna: teks model, receipt perubahan (`› write_file …`), daftar/artefak perintah | Harus bersih dari cursor-control pada non-TTY |
89
+ | stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
65
90
  | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
66
91
  | keduanya | Warna hanya bila stream TTY (`stdout.isTTY`); `NO_COLOR` menang; TERM/COLORTERM env TIDAK menyalakan warna pada pipe/redirect | Lihat `src/ui/render/theme.ts` `colorLevel()` |
67
92
 
@@ -82,13 +107,16 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
82
107
 
83
108
  ## Ownership
84
109
 
85
- - `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit —
86
- selalu berpasangan, termasuk exception/SIGINT via handler `process.on("exit")`
87
- sinkron best-effort). Turn berjalan = indikator spark pada status bar.
110
+ - `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit).
111
+ `TuiApp.run()` melepas listener/timer/subscription, memulihkan raw mode, dan
112
+ menutup layar lewat `finally` idempoten pada jalur sukses maupun exception.
113
+ Hook `process.on("exit")` hanya jaring best-effort terakhir, bukan pengganti
114
+ cleanup lifecycle. Turn berjalan = indikator spark pada status bar.
88
115
  - **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
89
116
  `process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
90
117
  tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
91
- → restore terminal (alt-screen exit + raw mode pulih) lalu
118
+ → restore terminal (alt-screen exit + raw mode pulih) tepat satu kali walau
119
+ handler sinyal terpanggil ulang, lalu
92
120
  `process.exit(128+n)`. Pasangan ketat: keduanya dilepas di cleanup `run()` —
93
121
  tanpa sesi TUI, sinyal TIDAK di-intercept (perilaku default proses tetap).
94
122
  Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
@@ -129,7 +157,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
129
157
  atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
130
158
  `dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
131
159
  sendiri.
132
- - **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 76,
160
+ - **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 52,
133
161
  form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
134
162
  Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
135
163
  hilang, id selamat).
@@ -188,8 +216,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
188
216
  live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
189
217
  layout paint tidak boleh memproyeksikan transcript dua kali.
190
218
 
191
- 13. Status bar: 1 baris dasar (`✦ 00.00.00 mode model cwd`) dari sumber
192
- yang sama dengan angka sesi. `✦` tetap menjadi indikator proses hidup;
219
+ 13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
220
+ context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
221
+ Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
222
+ konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
223
+ atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
224
+ menjadi indikator proses hidup;
193
225
  timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
194
226
  detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
195
227
  Reasoning memakai dots `...` → `..` → `.` → `..` →
@@ -204,7 +236,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
204
236
  **Shift+PgUp/PgDn (ESC[5;2~/6;2, modifier 2) = setengah halaman; Home/End
205
237
  saat prompt KOSONG = lompat baris-teratas/ekor transkrip (baris berisi =
206
238
  editing awal/akhir baris; dropdown terbuka = jalur engine)**; Up/Down
207
- histori; Tab/Shift+Tab mode; Ctrl+O/T compact/thinking; Ctrl+D baris-kosong
239
+ histori; Tab WorkMode / Shift+Tab PermissionMode; Ctrl+O/T compact/thinking; Ctrl+D baris-kosong
208
240
  keluar; Esc membersihkan selection lebih dulu, lalu batal input / abort
209
241
  turn (busy: SEMUA input dibekukan kecuali abort, scroll, dan selection —
210
242
  Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll selalu lolos
@@ -227,6 +259,14 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
227
259
  tetap pada ledger tool, status tool final memakai glyph + kata
228
260
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
229
261
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
262
+ **Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
263
+ `attemptId`. Bila attempt gagal setelah mengirim konten, TUI membuang
264
+ ekor attempt yang belum di-commit dan menambah diagnostic invalidasi.
265
+ Sink linear/pipe bersifat append-only: byte yang sudah ditulis tetap ada,
266
+ sehingga sink wajib menulis marker invalidasi sebelum output attempt
267
+ berikutnya. Konten attempt gagal dikeluarkan dari `/copy`, reasoning
268
+ durable, dan jawaban akhir; usage provider tetap dihitung karena request
269
+ tersebut sudah terjadi.
230
270
  **Grup anak (F-AGENT-1):** tool anak yang punya identitas run
231
271
  (`childSessionId`/`runId` — dari `ChildSessionLink`) tampil sebagai baris
232
272
  run sendiri, diindented `↳ <marker> <tool> <target> <status>` dengan
@@ -241,7 +281,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
241
281
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
242
282
  oldest-to-newest) melalui OSC 52.
243
283
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
244
- 20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 76,
284
+ 20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 52,
245
285
  form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
246
286
  selalu tampil.
247
287
  21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
@@ -330,20 +370,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
330
370
  invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
331
371
  35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
332
372
  dimensi yang BERJALAN BERSAMA, bukan pengganti:
333
- **Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
373
+ **Nilai runtime:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
334
374
  lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
335
375
  (ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
336
- approval prompt + ekstra rencana bila diizinkan PM) · `EXECUTE` (tanpa
337
- ceiling tambahan). Default `EXECUTE` = perilaku lama (kompatibel: sesi baru
338
- tanpa WorkMode eksplisit tetap EXECUTE).
339
- **Gerbang penolakan & side-effect ceiling:** permission handler tetap
340
- satu-satunya yang menentukan keamanan eksekusi. WorkMode hanya MEMASANG
341
- CEILING di atasnya; ia tidak pernah memperluas kewenangan permission mode
342
- dasar (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
376
+ pengawasan eksplisit + ekstra rencana bila diizinkan Tool Access Policy) ·
377
+ `EXECUTE` (tanpa ceiling tambahan). Nama produk `BUILD` memetakan ke
378
+ identitas internal `EXECUTE`; sesi baru memakai default `DISCUSS`.
379
+ **Gerbang penolakan & side-effect ceiling:** Tool Access Policy menentukan
380
+ capability yang tersedia; PermissionMode menentukan pengawasan persetujuan;
381
+ WorkMode memasang ceiling tambahan. Irisan ketiganya tidak pernah
382
+ memperluas akses (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
343
383
  hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
344
384
  ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
345
385
  serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
346
- **Command `/work-mode <DISCUSS|PLAN|EXECUTE>`:** aksi operator EKSPLISIT.
386
+ **Command `/work-mode <DISCUSS|PLAN|BUILD>`:** tiga nilai produk yang dapat
387
+ dipilih operator; `EXECUTE` hanya nama internal dan ditolak sebagai input.
347
388
  Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
348
389
  kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
349
390
  (handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
@@ -356,42 +397,47 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
356
397
  **Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
357
398
  (`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
358
399
  (`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
359
- sesi (baris legacy tanpa `work_mode` kembali ke default `EXECUTE`) dan
400
+ sesi (baris legacy tanpa `work_mode` kembali ke default `DISCUSS`; nilai
401
+ tersimpan `EXECUTE` lama ditampilkan sebagai `BUILD`) dan
360
402
  composition root menulis SATU baris stderr human-facing
361
403
  (`[resume] WorkMode <MODE> restored from session...` atau notice override/
362
404
  legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
363
405
  keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
364
406
  terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
365
407
  **Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
366
- footer (`<WorkMode>·<permission mode>`), di one-shot/exec linear lewat SATU
367
- baris stderr human-facing `[work-mode] <MODE> …` hanya saat WorkMode ≠
368
- EXECUTE (EXECUTE = default, tanpa baris), dan di `exec --json` lewat field
369
- terstruktur `summary.workMode` (selalu hadir, termasuk EXECUTE) — bukan teks
370
- dekoratif. ACP memakai `params.workMode` (terstruktur) dan tak menambah baris
408
+ footer (Work Mode kiri; Permission Mode kanan), di one-shot/exec linear
409
+ lewat SATU baris stderr human-facing `[work-mode] <MODE> …`, dan di
410
+ `exec --json` lewat field `summary.workMode` dengan nilai produk `DISCUSS`,
411
+ `PLAN`, atau `BUILD` — bukan teks dekoratif. ACP memakai `params.workMode`
412
+ (terstruktur) dan tak menambah baris
371
413
  dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
372
414
  vs `/mode`/`--plan`) dan dari status sesi.
373
- **Pemisahan dari permission mode:** Tab/Shift+Tab dan `/mode` TETAP
374
- khusus permission mode — WorkMode tak masuk siklus Tab. Permission mode
375
- yang memutuskan allow/deny per tool; WorkMode memilih postur
376
- (diskusi/rencana/bebas) dan hanya mempersempit.
415
+ **Pemisahan dari PermissionMode:** `Tab` memutar WorkMode;
416
+ `Shift+Tab` dan `/mode` mengubah PermissionMode. PermissionMode menentukan
417
+ pengawasan persetujuan (`AUTO`/`ASK`) dan Tool Access Policy menentukan
418
+ capability. WorkMode memilih postur (diskusi/rencana/bebas) dan hanya
419
+ mempersempit akses.
377
420
  **Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
378
- **per pemanggilan** dengan WorkMode **AKTIF** (transisi `/work-mode`
379
- langsung berlaku); sisi permission mode memakai **nilai startup sesi**
380
- (semantik lama dipertahankan — `Tab`/`Shift+Tab` menggeser mode izin di
381
- dalam handler, bukan nilai gate hooks). WorkMode `DISCUSS` tetap menahan
382
- hook walau permission mode `auto`.
383
- **Footer:** mode WorkMode aktif tampil sebagai
384
- `<WorkMode>·<permission mode>` hanya saat WorkMode ≠ EXECUTE (mis.
385
- `PLAN·auto`, `DISCUSS·auto`, `PLAN·readonly`); saat EXECUTE label
386
- permission mode apa adanya (mis. `auto`) — perilaku lama dipertahankan.
421
+ **per pemanggilan** dengan WorkMode dan PermissionMode **AKTIF**. Hooks
422
+ ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
423
+ `plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
424
+ PermissionMode AUTO/ASK.
425
+ **Footer:** Work Mode tampil di kiri dengan label produk `Work Mode: Build`,
426
+ `Work Mode: Plan`, atau `Work Mode: Discuss`; alias internal `EXECUTE` tidak
427
+ ditampilkan. Permission Mode tampil di kanan dekat token konteks sebagai
428
+ `Permission Mode: Auto` atau `Permission Mode: Ask`. Nilai Work Mode memakai
429
+ warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu mudah
430
+ dibedakan. Pada terminal sempit label dipadatkan, tetapi kedua nilai mode
431
+ dipertahankan selama lebar memungkinkan.
387
432
 
388
433
  ## Grammar (ringkas)
389
434
 
390
435
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
391
436
  berbingkai di atasnya) ·
392
- status bar `✦ 00.00.00 mode model cwd` (timer redup idle; detik putih aktif,
393
- menit mulai terang di 60 dtk, jam di 1 jam; tanpa bullet separator; mode =
394
- permission mode, atau `<WorkMode>·<permission mode>` bila WorkMode ≠ EXECUTE)
437
+ status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`
438
+ (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
439
+ jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
440
+ dipadatkan pada terminal sempit)
395
441
  + satu spacer sebelum footer · ledger tool
396
442
  ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
397
443
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
@@ -445,7 +491,7 @@ panjang).
445
491
  > **benar-benar di-assert** oleh test yang disebut. Kehadiran nama file test
446
492
  > bukan bukti klaim. Baris yang hanya "nominal" (test ada, tapi assertion-nya
447
493
  > tak menyentuh perilaku yang diklaim) dipindah ke bagian
448
- > [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup) di bawah — jangan
494
+ > [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
449
495
  > dipoles dengan mengganti kata-kata.
450
496
 
451
497
  - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (boot/exit pairing, transcript
@@ -506,14 +552,14 @@ panjang).
506
552
  Esc-1 kembalikan prefill, Esc-2 batal).
507
553
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
508
554
  stdout-pipe tanpa sink = deny).
509
- - `test/footer-render.test.ts` — I13 (footer minimal tanpa label status).
555
+ - `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).
510
556
  - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
511
- dievaluasi per pemanggilan tool; transisi EXECUTE↔DISCUSS↔PLAN pada sesi
557
+ dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
512
558
  yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
513
559
  WorkMode aktif; delegasi mewarisi WorkMode parent terbaru; argumen
514
560
  delegasi tak bisa menaikkan WorkMode; `/work-mode` end-to-end lewat TUI
515
- termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; label
516
- footer `PLAN·auto`/`DISCUSS·auto`).
561
+ termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; footer
562
+ memakai label title case; Tab mengubah WorkMode dan Shift+Tab tidak).
517
563
  - `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
518
564
  handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
519
565
  `web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
@@ -528,18 +574,23 @@ panjang).
528
574
  - `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
529
575
  tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
530
576
  - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
531
- resume > default EXECUTE; nilai invalid → EXECUTE + peringatan; `--verify`
577
+ resume > default DISCUSS; nilai invalid → DISCUSS + peringatan; input operator
578
+ hanya DISCUSS/PLAN/BUILD; `--verify`
532
579
  ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
533
580
  `workMode` parity).
534
- - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
535
- editing/busy, dots clock, timer, cursor, resize, popup). *Klausul "satu baris
536
- kosong memisahkan composer dari footer" TIDAK punya assertion — lihat
537
- [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup).*
581
+ - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I14/I17 (composer
582
+ editing/busy, dots clock, timer, cursor, resize, popup; teardown saat initial,
583
+ frame, event/timer, dan resize repaint gagal; abort/scroll saat layar menciut;
584
+ spacer composer-footer).
538
585
  - `test/markdown-table.test.ts` — I8/I11 (pipe-table parser, streaming
539
586
  parity, ANSI/CJK width, TTY/non-TTY, TUI resize, machine-output policy).
540
587
  - `test/terminal-contract.test.ts` — I2/I3/I7/I8/I9 (split stdout/stderr,
541
588
  kepemilikan layar tunggal, ledger satu baris per tool, streaming tanpa
542
589
  duplikasi, foreign writer boleh mentah).
590
+ - `test/provider-retry-output.test.ts`, `test/tui-transcript.test.ts`, dan
591
+ `test/presentation-events.test.ts` — invalidasi attempt provider gagal;
592
+ TUI/transkrip/history/`/copy` tidak menggabungkan teks gagal dengan jawaban
593
+ final, sementara sink linear memberi marker dan usage tetap tercatat.
543
594
  - `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
544
595
  picker/askLine, nesting, delayMs).
545
596
  - `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
@@ -563,7 +614,12 @@ panjang).
563
614
  - `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
564
615
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
565
616
  - `test/cli-commands.test.ts` — /status cetak, /sessions popup.
566
- - `test/screen.test.ts` — I16 (pairing + paintRegion).
617
+ - `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
618
+ mencoba memulihkan alt-screen dan reset region).
619
+ - `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
620
+ yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
621
+ - `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
622
+ diagnostik stderr, stdout kosong, exit 1, provider tidak dipanggil).
567
623
  - `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box).
568
624
  - `test/tui-overlay.test.ts` — I11/I16 (popup region + gate layar).
569
625
  - `test/ui-boundary.test.ts` — I1/I3 (src/ui tak impor keluar).
@@ -579,8 +635,9 @@ panjang).
579
635
  wizard, form error).
580
636
  - `test/sanitize.test.ts` — I2 (C1/bidi/tag dibuang, ZWJ dipertahankan;
581
637
  NO_COLOR menang di cleanUntrusted).
582
- - `test/width.test.ts` — I2/I7 (tab 8 kolom; truncate/chunk hanya-SGR +
583
- auto-reset; chunk(0) kosong).
638
+ - `test/width.test.ts` — I2/I7 + UI-RENDER-01 (VS16, skin tone, ZWJ, regional
639
+ indicator, keycap, combining mark; truncate/chunk tidak memecah grapheme;
640
+ tab 8 kolom; hanya-SGR + auto-reset; chunk(0) kosong).
584
641
  - `test/exit-codes.test.ts` — I28 (0/1/2 di semua handler; lookup tetap 1;
585
642
  hermetic subprocess).
586
643
  - `test/exec-json-envelope.test.ts` — I28 (summary ok:false di stdout saat
@@ -608,12 +665,13 @@ panjang).
608
665
  ESC[5;2~; hint abort pertama), I13 (MINICODE_MOTION=0: spark statis,
609
666
  env dibaca saat dipakai), I25 (kursor CUP parkir di dalam blok ?2026 yang
610
667
  sama), I21 (konstanta idle form 80+10 dtk + teks peringatan).
611
- - `test/pty.test.ts` — I13/I17/I31/I28 via BYTE STREAM NYATA (harness PTY
612
- `test/helpers/pty-harness.ts`, CLI di pseudo-terminal sesungguhan +
613
- provider fake hermetic): boot → ?1049h + timer idle, turn penuh end-to-end,
614
- drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse dihitung dari
615
- LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM → restore + exit
616
- 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
668
+ - `test/pty.test.ts` — I13/I17/I31/I28 + UI-RENDER-01 via BYTE STREAM NYATA
669
+ (harness PTY `test/helpers/pty-harness.ts`, CLI di pseudo-terminal
670
+ sesungguhan + provider fake hermetic): boot → ?1049h + timer idle, terminal
671
+ terlalu kecil menolak alt-screen, turn penuh, teks Unicode kompleks pada
672
+ frame produksi, drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse
673
+ dihitung dari LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM →
674
+ restore + exit 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
617
675
  sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
618
676
  bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
619
677
  Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
@@ -629,18 +687,19 @@ panjang).
629
687
  skip senyap. Parser SGR dan selection SGR tetap terverifikasi terpisah di
630
688
  `test/prompt-engine.test.ts` dan `test/tui-app.test.ts` (fake TTY).
631
689
 
632
- ### Gap proteksi (terbukti, belum ditutup)
690
+ ### Peta proteksi dan gap tersisa
633
691
 
634
- Bagian ini menahan klaim yang **benar secara implementasi tetapi belum punya
635
- assertion** yang menjaganya. Menutup gap = menambah test; mengubah
636
- kata-kata di sini TIDAK menutup gap.
692
+ Baris berstatus "ditutup" menunjukkan bukti yang tersedia saat ini. Gap tersisa
693
+ tetap UNVERIFIED; keberadaan implementasi saja bukan bukti UAT.
637
694
 
638
695
  | Klaim | Status implementasi | Yang hilang |
639
696
  |---|---|---|
640
- | I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: scroll/abort tetap lolos saat `tooSmall()`) | Tidak ada assertion. `test/tui-app.test.ts` ("terminal menciut tengah sesi") hanya asserting bahwa ketikan diabaikan + `Ctrl+D` keluar. |
641
- | I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Kata "spacer" tidak muncul di berkas test mana pun — tak ada assertion tinggi-geometry maupun rendah. |
697
+ | I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: PgUp/PgDn dan Esc diintercept sebelum `tooSmall()`) | Ditutup: `test/tui-app.test.ts` membuktikan scroll posisi baca bertahan saat layar dipulihkan dan Esc memanggil abort; `Ctrl+D` tetap jalan keluar terakhir. |
698
+ | I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Ditutup: `test/tui-app.test.ts` meng-assert baris spacer dalam frame penuh 14 baris. |
642
699
  | I20 — lebar kotak popup tetap per permukaan | Terimplementasi | `test/tui-app.test.ts` menandai salah satu test-nya sebagai `(I20)`, padahal test itu milik I13 (status bar). Lebar popup diverifikasi di `test/tui-geometry.test.ts` + `test/dialog.test.ts`; label di `tui-app` menyesatkan. |
643
700
  | I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
644
701
  | I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
645
702
  | I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
646
- | I3 — tak ada byte stdout bocor selama alternate-screen | Terimplementasi (TUI menulis UI ke stderr; stdout khusus pipe/envelope) | Belum ada test PTY yang meng-assert "stream stdout kosong selama alt-screen aktif" (hanya fake-TTY). Juga: job `ci-windows` TIDAK pernah menjalankan `pty*.test.ts` — suite PTY hanya tercapai lewat glob `test/p*.test.ts` di job ubuntu. |
703
+ | I3 — kepemilikan frame tunggal selama alternate-screen | `App` merender frame ke stdout; `simple` quiet dan transient stderr ditahan selama layar dimiliki TUI | Ditutup untuk jalur yang diuji: `test/terminal-contract.test.ts` memastikan printer linear quiet tetap tidak menulis, `test/pty.test.ts` mengamati frame produksi, dan `test/writer-inventory.test.ts` mengunci daftar writer. Suite PTY berjalan pada CI Linux; Windows ConPTY tidak menjalankan seluruh kasus PTY. |
704
+ | UI-COMPAT-01 — startup TUI gagal | Non-TTY/terminal tak mampu menolak fullscreen tanpa fallback linear; diagnostik stderr dan exit 1 | Ditutup: `test/tui-startup-failure.test.ts` menguji CLI produksi via subprocess; `test/pty.test.ts` menguji terminal di bawah minimum tanpa `?1049h`. Exit code PTY hanya diklaim jika platform mengembalikan angka. |
705
+ | UI-RENDER-02 — exception render melewati teardown | `TuiApp.run()` melakukan cleanup idempoten di `finally`; write frame melempar ke owner | Ditutup untuk initial paint, writer frame, dan event repaint: `test/tui-app.test.ts` + `test/screen.test.ts` memverifikasi alt-screen, raw mode, listener, subscription, timer dan sync-update. Sinyal POSIX diperiksa terpisah; Windows melewati test sinyal POSIX. |
@@ -0,0 +1,204 @@
1
+ # UI Render Pipeline — peta jalur provider stream → terminal
2
+
3
+ Dokumen ini hasil audit stabilitas UI/UX terminal 2026-09-18 (baseline v0.9.27).
4
+ Sumber kebenaran perilaku tetap `docs/TERMINAL_CONTRACT.md` (FROZEN); dokumen
5
+ ini memetakan IMPLEMENTASI aktual per tahap beserta kontrak event dan temuan
6
+ audit. Angka test di sini diukur di Windows + Bun 1.4.2, suite penuh hijau.
7
+
8
+ Konvensi: `file:line` menunjuk simbol yang dimaksud. Aturan repo tetap berlaku:
9
+ `cli/` boleh impor `src/ui/` dan `src/`; `src/` non-ui DILARANG impor
10
+ `src/ui/`; `src/ui/` DILARANG impor `cli/`, `src/` non-ui, `#minicore`
11
+ (dijaga `test/ui-boundary.test.ts`).
12
+
13
+ ## 1. Jalur pipeline (9 tahap)
14
+
15
+ Tahap A — provider stream mentah: `src/providers/router.ts` (fallback +
16
+ `provider:text/extension/tool_call/finish`), `src/providers/guards.ts:32`
17
+ (timeout + text-cap + stream-guard tunggal), adapter `anthropic.ts`,
18
+ `responses.ts`, `effort.ts`. Dirakit di `src/app/provider-layer.ts`.
19
+
20
+ Tahap B — kernel emit ke `session.events`: `vendor/minicore/src/core/loop.ts`
21
+ (`turn:started`, `provider:text` per chunk, `provider:extension`
22
+ reasoning/usage/error, `context:compacted` reason `pressure:*`/`recovery`,
23
+ `step:started/completed`), `executor.ts` (`execution:started/completed`),
24
+ `session.ts` (`turn:completed` HANYA di jalur sukses).
25
+
26
+ Tahap C — raw runtime/content contract: `src/ui/contract.ts:33` `UiEvent` masih
27
+ mencerminkan bentuk event kernel untuk streaming konten dan transport. Ledger,
28
+ status, lifecycle, dan keputusan user-facing melalui `PresentationEvent` +
29
+ `PresentationPolicy` dari `cli/setup.ts`; `attachSimpleLogger` dan
30
+ `attachTurnStatus` tetap memasang listener runtime per turn dan melepasnya di
31
+ `finally` agar event telat hening.
32
+
33
+ Tahap C2 — semantic presentation bridge: `cli/setup.ts` membuat
34
+ `PresentationAdapter`, mengurangi event ke `PresentationState` lengkap
35
+ (conversation, reasoning, system, plan, finding, result, diagnostic), menghitung
36
+ summary dari evidence, dan memuat ulang `presentation_events` saat resume. Bridge
37
+ memprojection seluruh `DomainEventType` melalui `toPresentationEvent()`;
38
+ `src/presentation/projection.ts` menyediakan keputusan policy murni (deskripsi
39
+ activity/turn, running pin, envelope machine) yang di-inject ke renderer sebagai
40
+ `PresentationPolicy`. Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`.
41
+
42
+ Tahap D — logger utama `src/ui/assistant/simple.ts:104`: append-only
43
+ scrollback, tanpa alternate screen. `provider:text` → `sanitizeAnsi` PER CHUNK
44
+ → `streamBuffer` → `flushBuf` (line-buffered) → `flushLine` (fence-state +
45
+ `decorateMarkdown` + `formatWrapped`) → `stdout`. Jawaban bisa minimize
46
+ (buffer 1MB + marker, dibuka via `/expand`).
47
+
48
+ Tahap E — garis status transient `src/ui/assistant/turn-status.ts`: satu baris
49
+ `stderr` untuk shell/linier, hidup hanya di fase sunyi (latch
50
+ `turnOn && !textOn`), hilang saat teks mengalir, hidup lagi saat tool
51
+ berikut. `endTurn()` deterministik dari driver `finally` (kernel tak emit
52
+ `completed` saat gagal/abort). TUI fullscreen tidak memakai painter transient
53
+ ini karena alternate screen dimiliki `TuiApp`.
54
+
55
+ Tahap F — arbitrator `src/ui/runtime/statusline.ts`: satu pemilik transient
56
+ (`turn` vs `spinner`); tulis asing saat painter aktif dikomit
57
+ (clear → tulis → repaint) sehingga diagnostik tak hilang; overlap = signal,
58
+ bukan crash. `paintWrite` tak pernah melempar (fail-closed Bun Windows).
59
+
60
+ Tahap G — status bar `src/ui/footer.ts` dirender `src/ui/tui/app.ts` sebagai
61
+ baris dasar frame fullscreen. `TuiApp` memiliki clock activity 200ms untuk
62
+ menggambar `✦`, timer `HH.MM.SS` di sebelah sparkle, dan dots reasoning
63
+ `...` → `..` → `.` tanpa label `Working`/`Thinking`/`Running`. Timer redup saat
64
+ idle dan putih saat aktif. Composer hanya menampilkan `minicode ›` setelah
65
+ Prompt tampil saat boot/idle, hilang saat busy, dan kembali otomatis setelah
66
+ turn selesai; aksi edit/histori tetap dapat membuka composer. Bullet separator
67
+ footer dihapus; field dipisahkan dengan spasi dan warna. Satu baris kosong memisahkan composer
68
+ dari footer; layout normal dan popup memakai helper geometri yang sama.
69
+ `TuiApp` mengaktifkan mouse tracking `?1002h + ?1006h` selama TUI; wheel
70
+ menggeser viewport transkrip, drag kiri membuat selection app-level, dan
71
+ `Ctrl+C` menyalin selection melalui DI/OSC52. Popup menurunkan ke mode
72
+ `?1000h`; tracking dimatikan pada quit, release, dan sinyal fatal.
73
+ Footer/chrome lama (`src/ui/runtime/chrome.ts`, DECSTBM scroll-region,
74
+ `MINICODE_FOOTER`) DIHAPUS bersama lapisan TUI lama — alternate screen
75
+ menggantikannya; nol byte di non-TTY. Footer baca `session.contextTokens` kernel
76
+ (bukan spend kumulatif).
77
+
78
+ Tahap H — primitif render `src/ui/render/`: `sanitize.ts` (hanya SGR lolos),
79
+ `markdown.ts` + `highlight.ts` (fence-state per baris, konten utuh),
80
+ `width.ts` (kolom: CJK/emoji 2, potong aman-SGR), `wrap.ts` (lebar dibaca
81
+ per baris → aman resize), `theme.ts` (getter warna/glyph, jangan di-`const`),
82
+ `errors.ts` (pesan actionable + redact), `collapse.ts` (buffer `/expand`
83
+ 200KB/entry, 500KB total), `markdown-table.ts`/`table-grid.ts` (pipe-table
84
+ model), `diff.ts`/`table.ts`/`money.ts`/`format.ts`.
85
+
86
+ Tahap H2 — tabel Markdown model: `src/ui/render/markdown-table.ts` memvalidasi
87
+ header/delimiter, escaped pipe, code span, alignment, dan fence; stream block
88
+ di-buffer sampai batas tabel. `table-grid.ts` menghitung lebar kolom dan budget
89
+ terminal, sedangkan linear/TUI me-render semantic block yang sama pada TTY dan
90
+ mempertahankan source sanitized pada non-TTY. `exec --json`/ACP tidak melewati
91
+ renderer ini.
92
+ Tahap I — view murni vs controller: `src/ui/screens/` (props + callback,
93
+ tanpa IO) digerakkan `cli/` (`tui.ts`, `commands.ts`, `wizard.ts`,
94
+ `provider/model-manager.ts`, `approval/prompt.ts` via DI `ask`,
95
+ `setupWhenEmpty`, `setSubAgentSessionFactory`).
96
+
97
+ ## 2. Kontrak Event → UI
98
+
99
+ Kolom: S = bisa di-stream, D = bisa duplikat, O = bisa out-of-order,
100
+ I = bisa diinterupsi, L = bisa tiba setelah completion.
101
+
102
+ | Event | Producer | Representasi UI | S | D | O | I | L |
103
+ |---|---|---|---|---|---|---|---|
104
+ | assistant text | provider stream | stdout wrap + fence 2-spasi; pipe-table-aligned di TTY, source sanitized di non-TTY | ya | tidak (E1) | tidak | ya (abort) | tidak (detach flush 1x, E6) |
105
+ | tool call | model → kernel | `› nama target` muted (compact: diam) | tidak | tidak | tidak | ya | tidak |
106
+ | tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer | tidak | tidak | tidak | ya | tidak |
107
+ | reasoning | provider extension | TUI composer: dots clock tanpa marker transcript; expanded transcript/linear tetap live per baris; minimized tetap buffer untuk `/expand` | ya | tidak | tidak | ya | tidak |
108
+ | thinking effort | picker `/model` | badge + level per model | tidak | tidak | tidak | tidak | tidak |
109
+ | usage | provider extension | verbose saja; masuk budget watcher | ya | tidak | ya (tail pasca-finish) | ya | ya (diabaikan aman) |
110
+ | compaction | kernel loop | `── compacted: <reason>` kuning, reason verbatim | tidak | tidak | tidak | tidak | tidak |
111
+ | permission request | executor → `ask` DI | header stdout + `askLine y/a/n`, fail-closed non-TTY | tidak | tidak | tidak | ya (deny) | tidak |
112
+ | permission denied | executor | error tool penuh, tak pernah minimize + reason | tidak | tidak | tidak | tidak | tidak |
113
+ | sub-agent | delegate_task → bus parent | ledger `›` biasa + usage; tanpa view khusus | tidak | tidak (jurnal skip forward) | tidak | ya | tidak |
114
+ | error provider | provider extension | `pendingError` consume-once → satu `✗` oleh driver | tidak | tidak (E15) | tidak | ya | tidak |
115
+ | warning | budget/recovery/verify | `[budget]`/`[recovery]`/`[verify]` kuning stderr | tidak | tidak (warned80 sekali) | tidak | tidak | tidak |
116
+ | completion | kernel loop | flush + `finalizeAnswer` + footer idle | tidak | tidak | tidak | tidak | tidak |
117
+ | abort | user/Esc | `(stopped)` + cleanup `finally` | tidak | tidak | tidak | — | tidak |
118
+ | timeout | kernel `createTimeout` | `✗ timeout` + turn dibuang transaksional | tidak | tidak | tidak | — | ya (late work ke turnStore privat, dibuang) |
119
+ | budget exceeded | watcher/driver | `[budget] … stopping turn` + abort ber-kind | tidak | tidak (fire-once) | tidak | — | tidak |
120
+ | provider failure | recovery policy | retry/compact/throw deterministik; cap retryAfter 30 dtk | tidak | tidak | tidak | tidak | tidak |
121
+
122
+ Mismatch yang dicari, hasil: raw EventBus tetap ada untuk konten/streaming,
123
+ tetapi keputusan user-facing kini membaca policy yang sama (raw ledger TUI
124
+ dihapus di Phase 8). Buffer jawaban live TUI dibatasi 1.000.000 karakter;
125
+ layout paint memakai satu proyeksi transcript dan cache render jawaban.
126
+ `cli/setup.ts:172-376` memproyeksikan seluruh `DomainEventType` secara
127
+ exhaustive; TUI memakai `describeActivity`/`matchTurn`/`elapsedVisible` via
128
+ injeksi, linear memakai deskripsi + `activityFor` untuk label turn-status, dan
129
+ machine memakai `toMachineEnvelope`. `bus-debug.ts` hanya debug subscription.
130
+ Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`,
131
+ `docs/OUTPUT_PROTOCOL_SPEC.md`, dan `docs/OUTPUT_RENDERING_SPEC.md`. State
132
+ turunan yang disengaja tetap footer memakai `contextTokens` (estimasi jendela), sedangkan `/status`
133
+ memisahkan Context/Input/Output/Total/Cost/Budget di
134
+ `docs/CONTROL-PLANE-MAP.md`.
135
+
136
+ ## 3. State machine TUI (tidak eksplisit)
137
+
138
+ Tidak ada `enum` state; fase disimpulkan: `abort !== null` (busy),
139
+ `turnOn/textOn` (painter), `regionOn/detached` (chrome), plus ~14 flag
140
+ (`mode`, `escTimer`, `pending`, `nullStreak`, `warned80`, `activeSection`,
141
+ minimize toggles, buffer, `pendingError`, raw-mode listener). Invarian dijaga
142
+ `finally`/`detachUI`/`endTurn`, bukan type-state. Transisi ilegal yang
143
+ terbukti dicegah: painter saat teks mengalir, `endTurn` ganda, error ganda,
144
+ `+`/`-` di pipe, decoder bocor antar prompt, Tab membajak search.
145
+ Satu lubang nyata: listener approval `askLine` menempel DI ATAS `onBusyKey`
146
+ selama busy (byte Ctrl+C diterima keduanya) — aman fail-closed
147
+ (`raceAbort` → deny) tetapi observabilitas ganda. Lihat §5 temuan O1.
148
+
149
+ ## 4. Temuan audit 2026-09-18 (eksperimen di /tmp, repo tak diubah)
150
+
151
+ F1 HIGH — SGR terbelah antar-chunk merusak output model. `sanitizeAnsi`
152
+ diterapkan PER CHUNK (`simple.ts:287`): `["\x1b[", "32mHello"]` tampil
153
+ literal `32mHello`. Bukti: harness E3 `out="32mHellom\n"`. Kelas sama untuk
154
+ OSC tak-terminasi (menelan sisa chunk). Perbaikan terkecil: tahan ekor
155
+ escape tak-lengkap di buffer dan sambung ke chunk berikut sebelum sanitasi.
156
+
157
+ F2 MEDIUM — SGR model bocor mentah ke stdout non-TTY. `"\x1b[31mRed\x1b[0m"`
158
+ satu chunk lolos `sanitizeAnsi` (by-design) lalu ditulis ke pipe apa adanya
159
+ (`out="\u001b[31mRed\u001b[0m\n"`), melanggar kontrak non-TTY deterministik.
160
+ Perbaikan terkecil: strip SGR (atau render via `c.*`) saat `!isTTY`.
161
+
162
+ F3 LOW — buffer thinking `/expand` membuang kepala diam-diam
163
+ (`thinkingBuf.slice(-200_000)` tanpa marker seperti `, capped 1MB` pada
164
+ answer). Informasi diagnostik hilang tanpa jejak.
165
+
166
+ O1 LOW — listener ganda approval vs busy-key (§3). Fail-closed, catat saja.
167
+
168
+ Status hardening (sesudah audit): F1 diperbaiki via `createStreamSanitizer`
169
+ + `splitTrailingEscape` di `src/ui/render/sanitize.ts` (dipakai jalur teks
170
+ model/reasoning/bash di `simple.ts`, flush deterministik saat
171
+ completed/detach); F2 via kebijakan `stripSgr` non-TTY di `wOut`/`wErr` +
172
+ `rememberTurn` (cerminan `colorLevel` → `stdout.isTTY`); F3 via marker
173
+ `… (earlier thinking truncated)`; O1 didokumentasikan di `src/ui/tui/app.ts`
174
+ (busy-freeze + abort, tanpa refactor). Snap kiri/kanan: render pertama sesudah
175
+ geometri berubah
176
+ me-reset jangkar relatif askLine (`lastGeoCols/Rows` di `input.ts`) —
177
+ geometri lebar tak dilacak footer karena erase baris-absolut tak sound
178
+ pasca-reflow (terbukti model + ConPTY: reflow milik konsumen).
179
+ Dijaga `test/ansi-fragmentation.test.ts`
180
+ (termasuk properti semua-titik-belah ≡ whole-string),
181
+ `test/non-tty-output.test.ts`, `test/thinking-truncation.test.ts`,
182
+ `test/ui-combined.test.ts` (satu sistem: stream + tool + resize + footer),
183
+ `test/input-resize.test.ts` (gagal di kode lama: CUP ke anchor basi).
184
+
185
+ Batas yang TERVERIFIKASI BENAR (bukti harness + 178 test UI hijau):
186
+ token-by-token tepat-1x (E1), chunk 50KB utuh (E2), fence terbelah benar
187
+ termasuk yatim saat abort (E4/E4b), abort flush tepat-1x tanpa bocor ke turn
188
+ berikut (E6), urutan teks>tool>hasil (E7), permission fail-closed (E8),
189
+ kontrak budget murni vs gate (E9), tiga reason kompaksi tampil beda (E10),
190
+ forward sub-agent sebagai ledger biasa (E11), tool 5000-baris dipotong +
191
+ ANSI jahat dibuang (E12), decoder UTF-8 per-byte + ESC-split + paste 100KB
192
+ (E13), soak 50 turn tepat-1x 38ms +4.6MB tanpa ESC mentah (E14),
193
+ error consume-once + format actionable (E15), resize 120→20 mid-stream aman
194
+ (E5b), 10k events 151k ev/s tepat-1x (E17), CJK/emoji/wrap/truncate/fence
195
+ (E5), emphasis tak-seimbang lewat literal + tabel konten-tetap (fidelitas).
196
+
197
+ ## 5. Residual risk (jujur, belum dibuktikan di audit ini)
198
+
199
+ Jalur TTY-live (painter denyut, footer sticky DECSTBM, overlay picker,
200
+ tombol busy) hanya tercakup harness fake-TTY + 178 test; tidak ada sesi TTY
201
+ nyata di audit ini. Chaos kombinasi (stream+resize+abort serentak di TTY)
202
+ dan soak 100+ turn multitool belum dijalankan. Sub-agent tanpa view khusus:
203
+ indukan dibedakan hanya dari nama tool (cukup untuk 1 level, belum diuji
204
+ visual untuk delegasi bertingkat — yang memang dilarang: tanpa nesting).
package/docs/agents.md CHANGED
@@ -5,20 +5,20 @@
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
- Approval: `delegate_task` di-**ASK** di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. Di **AUTO**, delegasi berjalan otonom bila authorized (anak tetap ter-ceiling WorkMode parent, dipaksa explore read-only bila parent non-BUILD). **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
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.**
9
9
 
10
10
  ## Mode anak: `explore` / `plan`
11
11
 
12
12
  | Mode anak | Kemampuan |
13
13
  |---|---|
14
- | `explore` | Subset read-only (12 tool) — cari/pahami kode, kembalikan temuan |
15
- | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode ketat** (`PLAN`/`DISCUSS`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `BUILD`×AUTO**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
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 |
16
16
 
17
- Restriksi anak yang **selalu** berlaku: anak **tidak** bisa bersarang (`delegate_task` dibuang), tidak bisa `git_commit`, tidak menulis memory/todo, tidak memakai `bash_output`/`bash_kill` (job milik parent). Tool MCP runtime (`server.tool`) hanya muncul pada anak `plan` di bawah parent `EXECUTE`; pada `explore` maupun parent non-`EXECUTE`, daftar anak dibatasi ke `EXPLORE_TOOL_NAMES`. Plan-parent dipaksa explore saat mendelegasi.
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
 
19
19
  ## Kenapa dibatasi
20
20
 
21
- Sub-agent menjalankan task tanpa Anda di depan layar. Kalau anak bisa commit atau memanggil MCP, satu prompt parent bisa menghasilkan efek yang tak Anda persetujui. Dengan membatasi anak ke read-only, efek samping tetap satu: eksekusi di parent — yang ledger-nya selalu Anda lihat.
21
+ Sub-agent menjalankan task tanpa Anda di depan layar. Karena itu kemampuan commit dan capability MCP tidak diteruskan; mode `explore` dan WorkMode ketat hanya memberi tool eksplorasi. Mode `plan` di bawah `BUILD` tetap dapat mengubah file atau menjalankan tool dasar, sehingga hasilnya harus ditinjau parent.
22
22
 
23
23
  ## Recovery
24
24