minicode-ai 0.14.2 → 0.14.5

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 (78) hide show
  1. package/README.md +34 -178
  2. package/cli/args.ts +10 -18
  3. package/cli/commands/acp.ts +20 -27
  4. package/cli/commands/daemon.ts +6 -7
  5. package/cli/commands/exec.ts +12 -10
  6. package/cli/commands.ts +6 -9
  7. package/cli/index.ts +30 -15
  8. package/cli/provider-manager.ts +1 -3
  9. package/cli/setup.ts +188 -143
  10. package/cli/tui.ts +15 -23
  11. package/docs/CONTROL-PLANE-MAP.md +145 -0
  12. package/docs/OUTPUT_EVENT_MODEL.md +1 -1
  13. package/docs/OUTPUT_PROTOCOL_SPEC.md +2 -2
  14. package/docs/OUTPUT_RENDERING_SPEC.md +7 -2
  15. package/docs/OUTPUT_UX_RULES.md +1 -1
  16. package/docs/README.md +14 -102
  17. package/docs/SUMMARY.md +53 -0
  18. package/docs/TERMINAL_CONTRACT.md +84 -51
  19. package/docs/UI_RENDER_PIPELINE.md +204 -0
  20. package/docs/agents.md +5 -5
  21. package/docs/architecture.md +23 -12
  22. package/docs/choosing-mode.md +7 -7
  23. package/docs/cli.md +22 -29
  24. package/docs/concepts.md +1 -1
  25. package/docs/config.md +10 -5
  26. package/docs/contributing.md +6 -6
  27. package/docs/environment.md +3 -1
  28. package/docs/exec.md +5 -5
  29. package/docs/glossary.md +8 -6
  30. package/docs/memory-sessions.md +7 -5
  31. package/docs/policy-sandbox.md +16 -14
  32. package/docs/quickstart.md +2 -2
  33. package/docs/repl.md +4 -3
  34. package/docs/security-model.md +14 -15
  35. package/docs/security.md +8 -29
  36. package/docs/skills.md +1 -1
  37. package/docs/tools.md +2 -2
  38. package/package.json +5 -3
  39. package/scripts/vendor-overlays/minicode-context.patch +109 -0
  40. package/src/app/provider-layer.ts +13 -1
  41. package/src/app/session.ts +231 -13
  42. package/src/config.ts +30 -3
  43. package/src/constants.ts +2 -0
  44. package/src/daemon/control.ts +1 -1
  45. package/src/mcp/server.ts +2 -3
  46. package/src/policy/compaction.ts +272 -16
  47. package/src/policy/context-window-catalog.ts +64 -0
  48. package/src/policy/context-window.ts +173 -0
  49. package/src/policy/context.ts +55 -3
  50. package/src/policy/pricing.ts +52 -0
  51. package/src/policy/ratelimit.ts +47 -18
  52. package/src/policy/usage.ts +15 -8
  53. package/src/policy/work-mode.ts +1 -1
  54. package/src/providers/guards.ts +61 -4
  55. package/src/providers/provision.ts +12 -3
  56. package/src/providers/router.ts +56 -23
  57. package/src/session/context-projection.ts +14 -0
  58. package/src/session/context-selector.ts +58 -20
  59. package/src/session/persistence.ts +1 -1
  60. package/src/task/model.ts +21 -70
  61. package/src/tools/task.ts +7 -0
  62. package/src/ui/footer.ts +131 -66
  63. package/src/ui/i18n/en.ts +0 -11
  64. package/src/ui/i18n/id.ts +0 -11
  65. package/src/ui/input/input.ts +2 -3
  66. package/src/ui/input/prompt-engine.ts +2 -5
  67. package/src/ui/screens/model-manager.ts +3 -10
  68. package/src/ui/screens/picker.ts +23 -40
  69. package/src/ui/screens/provider-manager.ts +12 -33
  70. package/src/ui/screens/wizard.ts +0 -1
  71. package/src/ui/tui/app.ts +10 -6
  72. package/src/ui/tui/transcript.ts +48 -8
  73. package/vendor/minicore/VENDOR.md +9 -5
  74. package/vendor/minicore/src/core/loop.ts +47 -12
  75. package/vendor/minicore/src/core/provider.ts +4 -0
  76. package/vendor/minicore/src/core/session.ts +14 -1
  77. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
  78. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
@@ -1,17 +1,38 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.5, 2026-11-06)
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.
2
24
 
3
25
  Perubahan v7.5: kepemilikan frame stdout interaktif diperjelas; cleanup `TuiApp.run()`
4
26
  berpasangan melalui `finally`; gap proteksi teardown, startup, spacer, layar kecil,
5
27
  dan writer ownership ditutup dengan test app/subprocess/PTY.
6
28
 
7
- Perubahan v7.4 (P12 S2.2 WorkMode): invarian baru I35 — WorkMode (lapis
8
- intent `DISCUSS`/`PLAN`/`EXECUTE`) sebagai dimensi TERPISAH dari permission
9
- mode. Command `/work-mode <DISCUSS|PLAN|EXECUTE>` (aksi operator eksplisit,
10
- transisi berlaku pada sesi yang sedang berjalan); footer menampilkan
11
- `<WorkMode>·<permission mode>` saat WorkMode ≠ EXECUTE (`PLAN·auto`,
12
- `DISCUSS·auto`, `PLAN·readonly`); `EXECUTE` (default) mempertahankan label
13
- permission mode seperti sebelumnya. Tab/Shift+Tab dan `/mode` TETAP khusus
14
- permission mode. Rincian di I35.
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.
15
36
 
16
37
  Perubahan v7.3 (P11 Presentation & UX): invarian baru I34 — subcommand `exec`
17
38
  dan `daemon` menerima argv SCOPE dari router (flag global dikenal yang
@@ -94,7 +115,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
94
115
  - **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
95
116
  `process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
96
117
  tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
97
- → 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
98
120
  `process.exit(128+n)`. Pasangan ketat: keduanya dilepas di cleanup `run()` —
99
121
  tanpa sesi TUI, sinyal TIDAK di-intercept (perilaku default proses tetap).
100
122
  Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
@@ -135,7 +157,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
135
157
  atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
136
158
  `dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
137
159
  sendiri.
138
- - **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,
139
161
  form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
140
162
  Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
141
163
  hilang, id selamat).
@@ -194,8 +216,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
194
216
  live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
195
217
  layout paint tidak boleh memproyeksikan transcript dua kali.
196
218
 
197
- 13. Status bar: 1 baris dasar (`✦ 00.00.00 mode model cwd`) dari sumber
198
- 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;
199
225
  timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
200
226
  detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
201
227
  Reasoning memakai dots `...` → `..` → `.` → `..` →
@@ -210,7 +236,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
210
236
  **Shift+PgUp/PgDn (ESC[5;2~/6;2, modifier 2) = setengah halaman; Home/End
211
237
  saat prompt KOSONG = lompat baris-teratas/ekor transkrip (baris berisi =
212
238
  editing awal/akhir baris; dropdown terbuka = jalur engine)**; Up/Down
213
- 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
214
240
  keluar; Esc membersihkan selection lebih dulu, lalu batal input / abort
215
241
  turn (busy: SEMUA input dibekukan kecuali abort, scroll, dan selection —
216
242
  Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll selalu lolos
@@ -255,7 +281,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
255
281
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
256
282
  oldest-to-newest) melalui OSC 52.
257
283
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
258
- 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,
259
285
  form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
260
286
  selalu tampil.
261
287
  21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
@@ -344,20 +370,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
344
370
  invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
345
371
  35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
346
372
  dimensi yang BERJALAN BERSAMA, bukan pengganti:
347
- **Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
373
+ **Nilai runtime:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
348
374
  lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
349
375
  (ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
350
- approval prompt + ekstra rencana bila diizinkan PM) · `EXECUTE` (tanpa
351
- ceiling tambahan). Default `EXECUTE` = perilaku lama (kompatibel: sesi baru
352
- tanpa WorkMode eksplisit tetap EXECUTE).
353
- **Gerbang penolakan & side-effect ceiling:** permission handler tetap
354
- satu-satunya yang menentukan keamanan eksekusi. WorkMode hanya MEMASANG
355
- CEILING di atasnya; ia tidak pernah memperluas kewenangan permission mode
356
- 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,
357
383
  hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
358
384
  ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
359
385
  serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
360
- **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.
361
388
  Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
362
389
  kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
363
390
  (handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
@@ -370,42 +397,47 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
370
397
  **Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
371
398
  (`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
372
399
  (`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
373
- 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
374
402
  composition root menulis SATU baris stderr human-facing
375
403
  (`[resume] WorkMode <MODE> restored from session...` atau notice override/
376
404
  legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
377
405
  keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
378
406
  terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
379
407
  **Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
380
- footer (`<WorkMode>·<permission mode>`), di one-shot/exec linear lewat SATU
381
- baris stderr human-facing `[work-mode] <MODE> …` hanya saat WorkMode ≠
382
- EXECUTE (EXECUTE = default, tanpa baris), dan di `exec --json` lewat field
383
- terstruktur `summary.workMode` (selalu hadir, termasuk EXECUTE) — bukan teks
384
- 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
385
413
  dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
386
414
  vs `/mode`/`--plan`) dan dari status sesi.
387
- **Pemisahan dari permission mode:** Tab/Shift+Tab dan `/mode` TETAP
388
- khusus permission mode — WorkMode tak masuk siklus Tab. Permission mode
389
- yang memutuskan allow/deny per tool; WorkMode memilih postur
390
- (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.
391
420
  **Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
392
- **per pemanggilan** dengan WorkMode **AKTIF** (transisi `/work-mode`
393
- langsung berlaku); sisi permission mode memakai **nilai startup sesi**
394
- (semantik lama dipertahankan — `Tab`/`Shift+Tab` menggeser mode izin di
395
- dalam handler, bukan nilai gate hooks). WorkMode `DISCUSS` tetap menahan
396
- hook walau permission mode `auto`.
397
- **Footer:** mode WorkMode aktif tampil sebagai
398
- `<WorkMode>·<permission mode>` hanya saat WorkMode ≠ EXECUTE (mis.
399
- `PLAN·auto`, `DISCUSS·auto`, `PLAN·readonly`); saat EXECUTE label
400
- 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.
401
432
 
402
433
  ## Grammar (ringkas)
403
434
 
404
435
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
405
436
  berbingkai di atasnya) ·
406
- status bar `✦ 00.00.00 mode model cwd` (timer redup idle; detik putih aktif,
407
- menit mulai terang di 60 dtk, jam di 1 jam; tanpa bullet separator; mode =
408
- 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)
409
441
  + satu spacer sebelum footer · ledger tool
410
442
  ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
411
443
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
@@ -520,14 +552,14 @@ panjang).
520
552
  Esc-1 kembalikan prefill, Esc-2 batal).
521
553
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
522
554
  stdout-pipe tanpa sink = deny).
523
- - `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).
524
556
  - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
525
- dievaluasi per pemanggilan tool; transisi EXECUTE↔DISCUSS↔PLAN pada sesi
557
+ dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
526
558
  yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
527
559
  WorkMode aktif; delegasi mewarisi WorkMode parent terbaru; argumen
528
560
  delegasi tak bisa menaikkan WorkMode; `/work-mode` end-to-end lewat TUI
529
- termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; label
530
- 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).
531
563
  - `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
532
564
  handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
533
565
  `web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
@@ -542,7 +574,8 @@ panjang).
542
574
  - `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
543
575
  tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
544
576
  - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
545
- resume > default EXECUTE; nilai invalid → EXECUTE + peringatan; `--verify`
577
+ resume > default DISCUSS; nilai invalid → DISCUSS + peringatan; input operator
578
+ hanya DISCUSS/PLAN/BUILD; `--verify`
546
579
  ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
547
580
  `workMode` parity).
548
581
  - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I14/I17 (composer
@@ -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
 
@@ -1,8 +1,8 @@
1
1
  # Arsitektur
2
2
 
3
- Peta struktur hidup yang interaktif ada di `ARCHITECTURE.html` (file pendamping di folder ini — search/filter, 9 section `00 Sekilas` → `09 UI/UX rendering terminal`). Halaman ini ringkasannya agar bisa dibaca GitBook + AI Ask.
3
+ Dokumen ini adalah peta struktur dan alur runtime yang aktif untuk kontributor.
4
4
 
5
- Rencana aktif: **roadmap arsitektur = `ROADMAP.md` di root repo** (master roadmap milik pemilik, disalin 2026-10-21) — di situulah posisi Big Phase P1–P14, next action arsitektur, dan status track Quality Remediation. `PLAN.md` di root tetap ada sebagai **ledger produk/milestone legacy** (`LEGACY-0.9/*`), bukan sumber status fase (lihat tabel disambiguasi di `AGENTS.md`). Kontrak terminal FROZEN: `TERMINAL_CONTRACT.md` (folder ini) — baca sebelum menyentuh output/rendering; perubahan perilaku wajib update dokumen + test peta proteksinya. Audit dan target output architecture: [OUTPUT_ARCHITECTURE_AUDIT.md](OUTPUT_ARCHITECTURE_AUDIT.md) beserta [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), [UX](OUTPUT_UX_RULES.md), dan [implementation plan](OUTPUT_IMPLEMENTATION_PLAN.md). Riset harness: `HARNESS.md` (folder ini). Arsip: `PLAN_UIUX_V6.md` (selesai, jangan dikerjakan ulang).
5
+ Roadmap fase pemilik tidak tersedia di checkout ini; jangan simpulkan status fase atau next action dari changelog maupun kode. `TERMINAL_CONTRACT.md` adalah kontrak terminal FROZEN — baca sebelum mengubah output; perubahan perilaku memerlukan pembaruan kontrak dan peta test. Kontrak output aktif ada di [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), dan [UX rules](OUTPUT_UX_RULES.md). Peta alur rendering ada di [UI Render Pipeline](UI_RENDER_PIPELINE.md).
6
6
 
7
7
  ## Tiga lapisan
8
8
 
@@ -12,6 +12,13 @@ L2 src/ non-ui → agen: tools, agents, hooks, policy, providers, mcp, lsp,
12
12
  L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (freeze, zero-dep, via #minicore)
13
13
  ```
14
14
 
15
+ Pin source kernel ada di [catatan vendor MiniCore](https://github.com/startupmini/minicode/blob/main/vendor/minicore/VENDOR.md):
16
+ `0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
17
+
18
+ Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
19
+ diterapkan saat sinkronisasi vendor; `VENDOR.md` mem-pin source, overlay, dan
20
+ fingerprint hasil akhirnya.
21
+
15
22
  - `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
16
23
  - Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
17
24
  - DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `createProviderLayer → loadLastModel → createRagLayer → resume presentation-events + planRecovery + reconcileUndoRedo → setupToolLayer + setAskTextFn → createMinicodeSession → journal + checkpoint + semantic event sink + step-trace + runPromptWithVerify (baseline-first + self-heal 3 siklus + hooks) → logger + turn-status + usage/pricing → persist/finalize → close (kill jobs, mcp/lsp close)`. `setSubAgentSessionFactory` sebelum dispatch agar TUI/one-shot/`mcp serve` tercakup.
@@ -29,13 +36,16 @@ dutinya:
29
36
  | Lapis | Isi | Authoritatif untuk |
30
37
  |---|---|---|
31
38
  | Kernel `ContextStore` | history yang dikirim ke model, bisa lossy saat kompaksi | window berjalan |
32
- | Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error` | continuity/resume |
33
- | Vektor memory + `presentation_events` | ringkasan compaction, evento semantik | RAG & audit UI |
39
+ | Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error`; dapat diganti saat shrink kompaksi | continuity/resume dari bentuk tersimpan saat ini |
40
+ | Vektor memory + `presentation_events` | ringkasan memory best-effort dan event semantik terpilih | RAG & audit UI; bukan salinan lengkap percakapan |
34
41
 
35
- `context_eviction ≠ state_loss`: memangkas yang working boleh, hilang dari
36
- durable tidak. Karena itu pagu summary kompaksi
37
- (`LIMITS.COMPACTION_SUMMARY_MAX_CHARS`) aman dipakai — fakta penuh tetap ada di
38
- `messages` dan vektor memory.
42
+ Kompaksi bersifat lossy, termasuk setelah restart. `persistCurrent` mengirim
43
+ history yang sudah dipadatkan ke `shrinkThreadHistory`, yang menghapus lalu
44
+ menulis ulang baris `messages`; model mekanis juga meringkas pesan lama dan
45
+ menghilangkan hasil tool yang sukses. Ringkasan ke vector memory hanya dibuat
46
+ di jalur LLM, dibatasi, opt-out, dan best-effort. Karena itu jangan menganggap
47
+ semua fakta lama tetap dapat dipulihkan dari sesi atau vector store; state
48
+ penting harus dicatat di task, file, atau artefak verifikasi yang otoritatif.
39
49
 
40
50
  Fidelity resume: `reasoning` (thinking) dan `is_error` (tool gagal) adalah
41
51
  field kernel `Message` yang ikut dibawa ke history. Semula keduanya tidak punya
@@ -82,8 +92,7 @@ Tiga aturan yang menjaga domain ini:
82
92
  bisa berbeda arah — dan plan event terbit di `execution:completed`, bukan
83
93
  dari argumen sebelum tool jalan.
84
94
 
85
- Batas subsystem **todo** (lihat `docs/TASK_ARCHITECTURE_AUDIT.md` untuk
86
- audit historisnya): file todo tetap datar — tanpa field dependency di
95
+ Batas subsystem **todo**: file todo tetap datar — tanpa field dependency di
87
96
  `TodoItem`, tanpa surface user (`/tasks`), `/undo` hanya revert file (todo
88
97
  tetap `completed`), dan tanpa TTL/GC untuk file todo di luar SQLite.
89
98
  Dependency/graph dan scheduler **sudah ada**, tetapi pada subsystem terpisah:
@@ -112,15 +121,17 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
112
121
 
113
122
  Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard) 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. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `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.
114
123
 
115
- 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 mode model cwd` (timer redup idle; saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; konteks rata kanan; 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` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
124
+ 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` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
116
125
 
117
126
  ## Modul kunci
118
127
 
119
128
  - `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.
120
129
 
121
130
  - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
122
- - `src/presentation/`: `events.ts` (25 semantic event types + proposed marker), `adapter.ts` (runtime → DomainEvent), `reducer.ts`/`model.ts` (replayable bounded state + derived summary), `store.ts` (content refs), `projection.ts` (policy node/mode + envelope `minicode.output.v1` + kategori error machine, murni), dan `src/session/persistence.ts` (`presentation_events` durable log + `messages` dengan fidelity `reasoning`/`is_error`). `cli/setup.ts` memiliki exhaustive `toPresentationEvent()` bridge; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy` (rollback flag dihapus di Phase 8).
131
+ - `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`.
123
132
  - `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).
124
133
  - `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
125
134
  - `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
135
+ - `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
136
+ - `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
126
137
  - Kualitas: `bench/`, `scripts/` (coverage/pack/telemetry/vendor), `experiments/` (adversarial).
@@ -12,16 +12,16 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
12
12
 
13
13
  | Saya ingin… | Gunakan | Karena |
14
14
  |---|---|---|
15
- | Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal (16 tool baca); network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
16
- | Minta agen membuat perubahan | `BUILD` + `AUTO` (default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
17
- | Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
15
+ | Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal; network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
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
+ | Menyetujui setiap perubahan | `--work-mode BUILD --ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
18
18
  | Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
19
- | Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
20
- | Otonom penuh di mesin sendiri | `BUILD`+`AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
19
+ | 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
+ | 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
21
 
22
22
  ## Rule of thumb
23
23
 
24
- 1. **Default `BUILD`+`AUTO` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
24
+ 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.
25
25
  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.
26
26
  3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
27
27
  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.
@@ -38,4 +38,4 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
38
38
  - [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
39
39
  - [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
40
40
  - [Otomasi & CI](exec.md) — batasan headless.
41
- - [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
41
+ - [CLI](cli.md) — referensi flag WorkMode/PermissionMode.