minicode-ai 0.14.6 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +6 -4
  2. package/cli/args.ts +20 -8
  3. package/cli/commands/exec.ts +17 -14
  4. package/cli/commands/openwork.ts +1 -1
  5. package/cli/commands.ts +39 -23
  6. package/cli/index.ts +29 -7
  7. package/cli/model-manager.ts +1 -1
  8. package/cli/router.ts +22 -9
  9. package/cli/setup.ts +77 -35
  10. package/cli/tui.ts +179 -25
  11. package/docs/CONTROL-PLANE-MAP.md +7 -5
  12. package/docs/OUTPUT_EVENT_MODEL.md +4 -3
  13. package/docs/OUTPUT_PROTOCOL_SPEC.md +1 -1
  14. package/docs/OUTPUT_RENDERING_SPEC.md +16 -4
  15. package/docs/OUTPUT_UX_RULES.md +38 -32
  16. package/docs/P14_OPEN_WORK.md +290 -0
  17. package/docs/README.md +1 -1
  18. package/docs/SUMMARY.md +36 -22
  19. package/docs/TERMINAL_CONTRACT.md +89 -17
  20. package/docs/UI_RENDER_PIPELINE.md +47 -8
  21. package/docs/agents.md +1 -1
  22. package/docs/architecture.md +10 -8
  23. package/docs/autonomous-scheduler.md +142 -0
  24. package/docs/choosing-mode.md +4 -2
  25. package/docs/cli.md +11 -9
  26. package/docs/concepts.md +5 -5
  27. package/docs/config-providers.md +3 -3
  28. package/docs/config.md +1 -1
  29. package/docs/contributing.md +7 -9
  30. package/docs/environment.md +8 -5
  31. package/docs/getting-started.md +5 -5
  32. package/docs/mcp-lsp.md +2 -2
  33. package/docs/memory-sessions.md +3 -3
  34. package/docs/policy-sandbox.md +7 -4
  35. package/docs/pricing-budget.md +3 -3
  36. package/docs/quickstart.md +1 -1
  37. package/docs/repl.md +11 -8
  38. package/docs/security-model.md +4 -2
  39. package/docs/security.md +9 -8
  40. package/docs/skills.md +2 -2
  41. package/docs/terminal.md +10 -2
  42. package/docs/tools.md +4 -4
  43. package/docs/troubleshooting.md +3 -3
  44. package/docs/verify-benchmark.md +0 -3
  45. package/package.json +9 -18
  46. package/scripts/vendor-overlays/minicode-context.patch +1 -1
  47. package/src/app/mentions.ts +1 -1
  48. package/src/app/rag-layer.ts +11 -2
  49. package/src/app/session.ts +128 -10
  50. package/src/constants.ts +32 -1
  51. package/src/daemon/client.ts +11 -6
  52. package/src/daemon/control.ts +2 -9
  53. package/src/daemon/resource.ts +5 -4
  54. package/src/hooks/run.ts +5 -6
  55. package/src/lib/keystore.ts +11 -9
  56. package/src/lib/net.ts +8 -3
  57. package/src/lib/safe-open.ts +29 -5
  58. package/src/lib/trusted-exec.ts +4 -1
  59. package/src/lsp/client.ts +9 -10
  60. package/src/mcp/http-transport.ts +1 -1
  61. package/src/mcp/server.ts +17 -7
  62. package/src/memory/files.ts +2 -1
  63. package/src/memory/vector.ts +25 -16
  64. package/src/policy/bash-guard.ts +58 -16
  65. package/src/policy/bpe.ts +110 -0
  66. package/src/policy/compaction.ts +139 -22
  67. package/src/policy/consequence-engine.ts +3 -3
  68. package/src/policy/context-window.ts +43 -1
  69. package/src/policy/context.ts +50 -12
  70. package/src/policy/jail.ts +48 -3
  71. package/src/policy/no-progress.ts +15 -8
  72. package/src/policy/permission.ts +243 -5
  73. package/src/policy/tokenizer-registry.ts +104 -0
  74. package/src/policy/usage.ts +20 -13
  75. package/src/policy/verifier.ts +7 -4
  76. package/src/policy/work-mode.ts +9 -5
  77. package/src/presentation/adapter.ts +8 -4
  78. package/src/presentation/events.ts +2 -2
  79. package/src/presentation/label.ts +3 -3
  80. package/src/presentation/model.ts +4 -0
  81. package/src/presentation/projection.ts +10 -2
  82. package/src/presentation/store.ts +2 -2
  83. package/src/providers/anthropic.ts +13 -3
  84. package/src/providers/responses.ts +16 -6
  85. package/src/runtime/capability.ts +22 -4
  86. package/src/runtime/child-execution.ts +1 -1
  87. package/src/runtime/composition.ts +5 -5
  88. package/src/runtime/execution-journal.ts +13 -7
  89. package/src/runtime/execution-registry.ts +1 -1
  90. package/src/runtime/production-execution.ts +7 -6
  91. package/src/runtime/production-runtime.ts +2 -2
  92. package/src/runtime/runtime-capabilities.ts +1 -1
  93. package/src/runtime/runtime-status-facts.ts +1 -1
  94. package/src/runtime/runtime-task-admission.ts +2 -2
  95. package/src/sandbox/os.ts +4 -3
  96. package/src/session/checkpoint.ts +29 -4
  97. package/src/session/context-assembly.ts +8 -1
  98. package/src/session/context-identity.ts +2 -2
  99. package/src/session/context-projection.ts +36 -11
  100. package/src/session/persistence.ts +22 -11
  101. package/src/task/autonomous-context.ts +2 -3
  102. package/src/task/autonomous-policy.ts +3 -3
  103. package/src/task/model.ts +2 -2
  104. package/src/task/production-scheduler.ts +2 -2
  105. package/src/task/scheduler-observability.ts +1 -0
  106. package/src/task/scheduler.ts +3 -2
  107. package/src/task/scheduling-policy.ts +2 -1
  108. package/src/task/trigger.ts +5 -5
  109. package/src/tools/git.ts +22 -4
  110. package/src/tools/lsp.ts +10 -8
  111. package/src/tools/read_image.ts +2 -1
  112. package/src/tools/task.ts +1 -1
  113. package/src/tools/web_fetch.ts +6 -2
  114. package/src/tools/web_search.ts +2 -1
  115. package/src/ui/assistant/simple.ts +42 -33
  116. package/src/ui/contract.ts +4 -0
  117. package/src/ui/footer.ts +63 -12
  118. package/src/ui/i18n/en.ts +14 -2
  119. package/src/ui/i18n/id.ts +14 -2
  120. package/src/ui/input/prompt-engine.ts +36 -10
  121. package/src/ui/render/cells.ts +320 -0
  122. package/src/ui/render/composer-wrap.ts +73 -0
  123. package/src/ui/render/detail.ts +2 -2
  124. package/src/ui/render/diff.ts +14 -5
  125. package/src/ui/render/highlight.ts +4 -4
  126. package/src/ui/render/ledger.ts +47 -0
  127. package/src/ui/render/markdown.ts +12 -5
  128. package/src/ui/render/session-summary.ts +50 -0
  129. package/src/ui/render/table-grid.ts +134 -6
  130. package/src/ui/render/theme.ts +49 -4
  131. package/src/ui/render/width.ts +91 -4
  132. package/src/ui/render/wrap.ts +5 -3
  133. package/src/ui/runtime/screen.ts +100 -22
  134. package/src/ui/runtime/statusline.ts +26 -0
  135. package/src/ui/screens/model-manager.ts +1 -1
  136. package/src/ui/session-state.ts +27 -1
  137. package/src/ui/tui/app.ts +336 -65
  138. package/src/ui/tui/transcript.ts +335 -104
  139. package/vendor/minicore/VENDOR.md +16 -12
  140. package/vendor/minicore/src/core/events.ts +1 -0
  141. package/vendor/minicore/src/core/loop.ts +11 -1
  142. package/vendor/minicore/src/core/session.ts +39 -0
@@ -1,4 +1,28 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.9, 2026-11-07)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.12, 2026-11-10)
2
+
3
+ Perubahan v7.12: footer `context` & `metrics` (window %) kini **live per step**
4
+ selama turn berjalan — kernel meng-emit estimasi konteks turn-store via event
5
+ `provider:extension` kind `context-window` SETELAH `step:completed`, dan footer
6
+ membacanya alih-alih terpaku pada `session.contextTokens` (committed store yang
7
+ hanya berubah saat `turn:completed`). Saat idle, footer kembali ke nilai
8
+ committed. Estimator sama sekali tidak berubah/berduplikasi — tetap satu sumber
9
+ (`estimateSessionContext`), hanya nilai yang dibaca saat turn aktif memakai
10
+ turn-store (yang tumbuh), bukan committed store (beku). Sumber: `vendor/minicore/
11
+ src/core/loop.ts` (emit) + `cli/tui.ts` (wiring footer).
12
+
13
+ Perubahan v7.11: thinking & jawaban di TUI dan renderer linear kini membungkus di
14
+ batas kata (`wrapByWidth`) — tidak memotong di tengah kata — dan baris diff ikut
15
+ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
16
+ (v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
17
+
18
+ Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
19
+ sebagai **ikon gembok** `🔒` di ujung footer (setelah Permission Mode), terang
20
+ saat aktif (mode Auto + restrictBash) dan redup saat nonaktif. Sumbu persetujuan
21
+ tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
22
+ sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
23
+ bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
24
+ terkalibrasi yang memakai estimator yang SAMA dengan guard cutoff, sehingga
25
+ footer dan guard tidak pernah menghasilkan dua angka sumber berbeda.
2
26
 
3
27
  Perubahan v7.9: input command slash tidak ditambahkan sebagai pesan transkrip;
4
28
  aksi popup provider/model/sesi dan toggle UI tidak meninggalkan riwayat status
@@ -87,7 +111,7 @@ proteksi").
87
111
  | Stream | Isi | Catatan |
88
112
  |---|---|---|
89
113
  | stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
90
- | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
114
+ | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (default terlihat; `MINICODE_SHOW_THINKING=0` minimized), warning, error | Boleh transient rendering bila stderr TTY |
91
115
  | 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()` |
92
116
 
93
117
  Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
@@ -188,13 +212,30 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
188
212
  - Layar tak mampu (non-TTY, `rows < 10`, `TERM=dumb`): view menolak BERSUARA
189
213
  + batal (fail-closed). TAK BOLEH diam.
190
214
  - `/status` & `/history` = readout ke transkrip (bukan popup); `/help` ringkas
191
- (≤6 baris, penuh via `/help tombol`); `/expand` membuka buffer isi tool;
192
- pilihan `/model` persist antar sesi + struk `model: x` di transkrip.
215
+ (terkelompok ≤8 baris, penuh via `/help full`, pintasan via `/help keys`);
216
+ `/expand` membuka buffer isi tool; pilihan `/model` persist antar sesi +
217
+ struk `model: x` di transkrip.
193
218
 
194
219
  ## Invariant (nomor dipakai di peta proteksi)
195
220
 
196
221
  1. Satu tampilan interaktif: TUI fullscreen; frame penuh tiap repaint (tepat
197
- `rows` baris); scrollback utama tak tersentuh selama sesi.
222
+ `rows` baris); scrollback utama tak tersentuh selama sesi. Frame LOGIS tetap
223
+ penuh `rows` baris (hasil layar identik), namun PENULISAN FISIK ke terminal
224
+ boleh inkremental per SEL dan dikirim sebagai SATU `write` per frame
225
+ (`screen.paint` memakai diff sel terhadap frame sebelumnya; repaint
226
+ pertama/resize/perubahan jumlah kolom tetap `ESC[H`+`ESC[2J` clear penuh)
227
+ — ini murni optimasi menghapus flicker/latensi `ESC[2J` tiap keystroke,
228
+ bukan perubahan perilaku yang terlihat. Diff per sel menyimpan gaya sebagai
229
+ STATE SGR ternormalisasi (urutan kanonik, bukan riwayat sekuens), sehingga
230
+ sel yang identik secara visual tidak pernah ditulis ulang; glyph lebar
231
+ (CJK/emoji) dilindungi sel lanjutan (`cont`) agar diff tidak memotong glyph.
232
+ Penulisan per baris berubah: dari kolom berbeda PERTAMA sampai akhir baris
233
+ (prefix identik dilewati), didahului EL (`ESC[0K`) — ekor dihapus-lalu-ditulis
234
+ ulang supaya sisa glyph lebar / ekor baris lama tidak menempel. Tulis asing ke
235
+ stderr selama alt-screen hidup (mis. `[hooks] skipped …`, warning provider)
236
+ menandai terminal "kotor" (`statusline.consumeScreenDrift`) dan memaksa
237
+ repaint penuh pada paint berikutnya; tanpa ini baris yang kebetulan tak
238
+ berubah akan mempertahankan fragmen asing di atas diff inkremental.
198
239
  2. stdout/stderr contract seperti tabel di atas (TTY & non-TTY deterministic).
199
240
  3. Satu kepemilikan layar (`App`); popup satu lifecycle (`suspend`/`resume` +
200
241
  `paintRegion`).
@@ -218,6 +259,14 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
218
259
 
219
260
  13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
220
261
  context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
262
+ Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
263
+ LIVE turn-store yang di-emit kernel per step (event `provider:extension`
264
+ kind `context-window`, setelah `step:completed`); saat idle kembali ke
265
+ `session.contextTokens` (committed store). Estimator tetap satu sumber —
266
+ hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
267
+ (beku), tak ada duplikasi angka sumber (v7.12).
268
+ Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
269
+ bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
221
270
  Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
222
271
  konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
223
272
  atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
@@ -256,7 +305,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
256
305
  saat turn). Composer memakai tinggi tetap: prompt saat editing, dots saat
257
306
  reasoning, atau tool target; satu baris kosong selalu memisahkannya dari
258
307
  footer. Proyeksi presentasi: baris running di-pin dari snapshot, elapsed
259
- tetap pada ledger tool, status tool final memakai glyph + kata
308
+ tetap pada ledger tool, status tool final memakai warna + kata
260
309
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
261
310
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
262
311
  **Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
@@ -292,9 +341,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
292
341
  di footer form ("batal dalam 10 dtk" — bukan countdown hidup), 10 dtk
293
342
  berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
294
343
  ketikan apa pun me-reset kedua timer.
295
- 22. Thinking terlihat: composer memakai dots clock; transkrip minimized =
296
- bersih tanpa marker (`… thinking`), expanded = alir redup; isi tetap
297
- tersedia di `/expand`; fase berakhir = commit (tak ada thinking yatim).
344
+ 22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
345
+ transkrip expanded = alir thinking ber-warna terbaca (`c.thinking`,
346
+ abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
347
+ jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
348
+ = bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
349
+ fase berakhir = commit (tak ada thinking yatim).
298
350
  23. Approval & ask_user tercatat di transkrip (pertanyaan + keputusan) dan
299
351
  terlihat sebelum menjawab; non-TTY = deny/null fail-closed; stdout
300
352
  di-pipe tanpa sink TUI = deny/null (prompt tak terlihat + mencemari
@@ -303,7 +355,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
303
355
  dengan id membaca satu tool, tanpa id membaca seluruh entry store yang
304
356
  masih hidup; miss → durable sqlite → penanda retensi. Pilihan `/model`
305
357
  persist antar sesi + struk `model: x`; `/help` ringkas (penuh via
306
- `/help tombol`).
358
+ `/help full`, pintasan via `/help keys`).
307
359
  25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
308
360
  backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
309
361
  (`↑↓`, pgup/pgdn, home/end) di semua popup; hint footer akurat
@@ -434,20 +486,25 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
434
486
 
435
487
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
436
488
  berbingkai di atasnya) ·
437
- status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`
489
+ status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto 🔒`
438
490
  (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
439
491
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
440
- dipadatkan pada terminal sempit)
492
+ dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
441
493
  + satu spacer sebelum footer · ledger tool
442
- ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
494
+ ` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
443
495
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
444
496
  `src/ui/render/errors.ts`): credential di-redaksi (bearer/key/query), escape
445
497
  ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
446
- pernah tampil · thinking: dots clock / alir redup · popup: konten redup di
498
+ pernah tampil · thinking: dots clock / alir thinking terbaca · popup: konten redup di
447
499
  belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
448
500
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
449
501
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
450
- Projection V2: `› name target … running`, ledger status ber-glyph/kata,
502
+ `/fold` = lipat aktivitas tool per turn (`MINICODE_MINIMIZE_ACTIVITY`, ON di TUI) —
503
+ baris ledger per-tool dirangkum jadi SATU baris ringkas (`n tools · nama · x ok · y gagal`),
504
+ tidak hilang diam-diam; detail dibuka via `/expand` ·
505
+ tabel markdown dirender kotak ber-garis (opencode-like) ber-`wrap` (konten panjang
506
+ tidak kepotong) + margin kiri 1 kolom; teks paragraf ber-margin kiri 1 kolom ·
507
+ Projection V2: `› name target … running`, ledger status ber-warna/kata,
451
508
  retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
452
509
  identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
453
510
  sesuai flag ·
@@ -552,7 +609,10 @@ panjang).
552
609
  Esc-1 kembalikan prefill, Esc-2 batal).
553
610
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
554
611
  stdout-pipe tanpa sink = deny).
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).
612
+ - `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, ikon gembok 🔒 terang/redup).
613
+ - `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
614
+ kind `context-window` berisi `usedTokens`/`windowTokens` setelah
615
+ `step:completed` — sumber live-occupancy footer; nilai > 0 terbukti).
556
616
  - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
557
617
  dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
558
618
  yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
@@ -615,7 +675,19 @@ panjang).
615
675
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
616
676
  - `test/cli-commands.test.ts` — /status cetak, /sessions popup.
617
677
  - `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
618
- mencoba memulihkan alt-screen dan reset region).
678
+ mencoba memulihkan alt-screen dan reset region) + I1 (satu `write` per frame;
679
+ repaint penuh saat frame pertama / drift stderr / perubahan kolom, dan diff
680
+ inkremental per sel pada paint berikutnya yang setara — bukan clear `ESC[2J`
681
+ tiap keystroke).
682
+ - `test/cells.test.ts` — I1 (tokenizer sel grapheme + diff "tulis-ulang ekor":
683
+ prefix identik nol byte, dari kolom berbeda pertama sampai akhir baris ditulis
684
+ ulang setelah EL `ESC[0K`; start mundur ke sel pembawa glyph agar EL tak
685
+ membelah glyph lebar; state SGR ternormalisasi urutan kanonik — `ESC[39m`
686
+ membatalkan bukan menumpuk, `38;5;n`/`38;2;r;g;b` utuh, glyph lebar dilindungi
687
+ `cont`; fuzz 500 kasus paritas output vs referensi).
688
+ - `test/composer-wrap.test.ts` — I1 (wrap composer inkremental paritas dengan
689
+ `chunkByWidth` penuh untuk append/backspace di ujung, CJK lebar, multiline;
690
+ pola tak didukung → fallback).
619
691
  - `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
620
692
  yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
621
693
  - `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
@@ -13,7 +13,7 @@ Konvensi: `file:line` menunjuk simbol yang dimaksud. Aturan repo tetap berlaku:
13
13
  ## 1. Jalur pipeline (9 tahap)
14
14
 
15
15
  Tahap A — provider stream mentah: `src/providers/router.ts` (fallback +
16
- `provider:text/extension/tool_call/finish`), `src/providers/guards.ts:32`
16
+ `provider:text` + `provider:extension`), `src/providers/guards.ts:32`
17
17
  (timeout + text-cap + stream-guard tunggal), adapter `anthropic.ts`,
18
18
  `responses.ts`, `effort.ts`. Dirakit di `src/app/provider-layer.ts`.
19
19
 
@@ -23,7 +23,7 @@ reasoning/usage/error, `context:compacted` reason `pressure:*`/`recovery`,
23
23
  `step:started/completed`), `executor.ts` (`execution:started/completed`),
24
24
  `session.ts` (`turn:completed` HANYA di jalur sukses).
25
25
 
26
- Tahap C — raw runtime/content contract: `src/ui/contract.ts:33` `UiEvent` masih
26
+ Tahap C — raw runtime/content contract: `src/ui/contract.ts` (`UiEvent`) masih
27
27
  mencerminkan bentuk event kernel untuk streaming konten dan transport. Ledger,
28
28
  status, lifecycle, dan keputusan user-facing melalui `PresentationEvent` +
29
29
  `PresentationPolicy` dari `cli/setup.ts`; `attachSimpleLogger` dan
@@ -39,7 +39,8 @@ memprojection seluruh `DomainEventType` melalui `toPresentationEvent()`;
39
39
  activity/turn, running pin, envelope machine) yang di-inject ke renderer sebagai
40
40
  `PresentationPolicy`. Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`.
41
41
 
42
- Tahap D — logger utama `src/ui/assistant/simple.ts:104`: append-only
42
+ Tahap D — logger utama `src/ui/assistant/simple.ts` (`attachSimpleLogger`):
43
+ append-only
43
44
  scrollback, tanpa alternate screen. `provider:text` → `sanitizeAnsi` PER CHUNK
44
45
  → `streamBuffer` → `flushBuf` (line-buffered) → `flushLine` (fence-state +
45
46
  `decorateMarkdown` + `formatWrapped`) → `stdout`. Jawaban bisa minimize
@@ -91,7 +92,7 @@ mempertahankan source sanitized pada non-TTY. `exec --json`/ACP tidak melewati
91
92
  renderer ini.
92
93
  Tahap I — view murni vs controller: `src/ui/screens/` (props + callback,
93
94
  tanpa IO) digerakkan `cli/` (`tui.ts`, `commands.ts`, `wizard.ts`,
94
- `provider/model-manager.ts`, `approval/prompt.ts` via DI `ask`,
95
+ `model-manager.ts`, `provider-manager.ts`, `src/ui/approval/prompt.ts` via DI `ask`,
95
96
  `setupWhenEmpty`, `setSubAgentSessionFactory`).
96
97
 
97
98
  ## 2. Kontrak Event → UI
@@ -111,11 +112,11 @@ I = bisa diinterupsi, L = bisa tiba setelah completion.
111
112
  | permission request | executor → `ask` DI | header stdout + `askLine y/a/n`, fail-closed non-TTY | tidak | tidak | tidak | ya (deny) | tidak |
112
113
  | permission denied | executor | error tool penuh, tak pernah minimize + reason | tidak | tidak | tidak | tidak | tidak |
113
114
  | 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
+ | error provider | provider extension | `pendingError` consume-once → satu pesan error berwarna oleh driver | tidak | tidak (E15) | tidak | ya | tidak |
115
116
  | warning | budget/recovery/verify | `[budget]`/`[recovery]`/`[verify]` kuning stderr | tidak | tidak (warned80 sekali) | tidak | tidak | tidak |
116
117
  | completion | kernel loop | flush + `finalizeAnswer` + footer idle | tidak | tidak | tidak | tidak | tidak |
117
118
  | 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
+ | timeout | kernel `createTimeout` | `timeout` (berwarna) + turn dibuang transaksional | tidak | tidak | tidak | — | ya (late work ke turnStore privat, dibuang) |
119
120
  | budget exceeded | watcher/driver | `[budget] … stopping turn` + abort ber-kind | tidak | tidak (fire-once) | tidak | — | tidak |
120
121
  | provider failure | recovery policy | retry/compact/throw deterministik; cap retryAfter 30 dtk | tidak | tidak | tidak | tidak | tidak |
121
122
 
@@ -123,7 +124,7 @@ Mismatch yang dicari, hasil: raw EventBus tetap ada untuk konten/streaming,
123
124
  tetapi keputusan user-facing kini membaca policy yang sama (raw ledger TUI
124
125
  dihapus di Phase 8). Buffer jawaban live TUI dibatasi 1.000.000 karakter;
125
126
  layout paint memakai satu proyeksi transcript dan cache render jawaban.
126
- `cli/setup.ts:172-376` memproyeksikan seluruh `DomainEventType` secara
127
+ `cli/setup.ts` (`toPresentationEvent()`) memproyeksikan seluruh `DomainEventType` secara
127
128
  exhaustive; TUI memakai `describeActivity`/`matchTurn`/`elapsedVisible` via
128
129
  injeksi, linear memakai deskripsi + `activityFor` untuk label turn-status, dan
129
130
  machine memakai `toMachineEnvelope`. `bus-debug.ts` hanya debug subscription.
@@ -179,7 +180,8 @@ pasca-reflow (terbukti model + ConPTY: reflow milik konsumen).
179
180
  Dijaga `test/ansi-fragmentation.test.ts`
180
181
  (termasuk properti semua-titik-belah ≡ whole-string),
181
182
  `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/tui-format.test.ts` (stdout/stderr + ledger tool), `test/footer-render.test.ts`
184
+ (footer),
183
185
  `test/input-resize.test.ts` (gagal di kode lama: CUP ke anchor basi).
184
186
 
185
187
  Batas yang TERVERIFIKASI BENAR (bukti harness + 178 test UI hijau):
@@ -202,3 +204,40 @@ nyata di audit ini. Chaos kombinasi (stream+resize+abort serentak di TTY)
202
204
  dan soak 100+ turn multitool belum dijalankan. Sub-agent tanpa view khusus:
203
205
  indukan dibedakan hanya dari nama tool (cukup untuk 1 level, belum diuji
204
206
  visual untuk delegasi bertingkat — yang memang dilarang: tanpa nesting).
207
+
208
+ ## 6. Optimasi latensi ketik & biaya salin (fase 1–4, pasca-audit)
209
+
210
+ Ringkasan: TUI tetap penuh `rows` baris secara LOGIS; yang diperkecil hanyalah
211
+ byte FISIK yang ditulis. Kontrak perilaku user-visible tidak berubah, jadi
212
+ `TERMINAL_CONTRACT.md` I1 adalah sumber kebenaran.
213
+
214
+ - **Fase 1 — satu `write` per frame.** `screen.paint` merakit seluruh frame
215
+ (masuk blok sinkronis `ESC[?2026h`/`ESC[?2026l`) menjadi SATU string lalu
216
+ menulisnya sekali ke `process.stdout`. Menghapus sejumlah `write` kecil per
217
+ frame yang membuat ConPTY membangun ulang potongan.
218
+ - **Fase 2 — diff per sel.** `src/ui/render/cells.ts` memecah baris menjadi sel
219
+ (grapheme + STATE SGR ternormalisasi) dan menghasilkan byte minimal:
220
+ prefix identik dilewati (nol byte), lalu dari kolom berbeda PERTAMA sampai
221
+ akhir baris ditulis ulang setelah EL `ESC[0K`. Start mundur ke sel pembawa
222
+ glyph agar EL tidak membelah glyph lebar; kolom lanjutan ditandai `cont`.
223
+ Frame pertama / resize / perubahan jumlah kolom tetap `ESC[H`+`ESC[2J`.
224
+ - **Fase 2b — invalidasi drift.** Tulis asing ke stderr selama alt-screen hidup
225
+ (mis. `[hooks] skipped …`, warning provider) mengotori buffer di balik
226
+ pelacakan diff; `statusline` menandainya (`consumeScreenDrift`) dan layar
227
+ memaksa repaint penuh sekali. `beginInteractiveScreen` memasang wrapper
228
+ stderr saat depth 0→1 supaya sinyal ini terpasang bahkan tanpa owner transient.
229
+ Tanpa ini baris yang kebetulan tak berubah akan mempertahankan fragmen asing.
230
+ - **Fase 3 — hot path editor.** `screen.moveCursor` untuk fast-path kursor-saja
231
+ (tanpa merakit ulang frame); `prompt-engine.ts` memakai memo grapheme 1-entri
232
+ + fast path ASCII; `composer-wrap.ts` melakukan wrap inkremental saat append/
233
+ backspace di ujung, jatuh ke `chunkByWidth` penuh bila pola tak didukung.
234
+ - **Fase 4 — biaya salin.** `transcript.selectionText` memakai binary search
235
+ (`orderLowerBound`) + `selectionIsEmpty` murah; guard OSC 52 berbasis byte
236
+ (`MAX_CLIPBOARD_BYTES`/`MAX_SELECTION_BYTES` = 256 KiB) di `simple.ts` dan
237
+ `app.ts`; `/copy` dibatasi total byte dan melaporkan `tui.copyTooLarge`.
238
+
239
+ Penjaga: `test/cells.test.ts` (paritas diff vs tulis-penuh + minimalitas),
240
+ `test/composer-wrap.test.ts` (paritas wrap inkremental), `test/screen.test.ts`
241
+ (satu `write`/frame, repaint penuh pada drift/frame pertama, diff setara),
242
+ plus `test/pty.test.ts` / `test/screen-buffer.test.ts` untuk verifikasi buffer
243
+ nyata. Angka hasil historis (laporan sebelumnya) tetap berstatus historical.
package/docs/agents.md CHANGED
@@ -18,7 +18,7 @@ Restriksi anak yang **selalu** berlaku: `delegate_task`, `git_commit`, memory/to
18
18
 
19
19
  ## Kenapa dibatasi
20
20
 
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.
21
+ Sub-agent menjalankan task tanpa Anda di depan layar. Karena itu kemampuan commit dan tool dinamis MCP tidak diteruskan; mode `explore` dan WorkMode ketat hanya memberi tool eksplorasi (tool MCP built-in pun tersaring). Mode `plan` di bawah `BUILD` tetap dapat mengubah file, menjalankan tool dasar, dan memakai tool MCP built-in bila diotorisasi, sehingga hasilnya harus ditinjau parent.
22
22
 
23
23
  ## Recovery
24
24
 
@@ -12,7 +12,7 @@ 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):
15
+ Pin source kernel ada di [catatan vendor MiniCore](https://github.com/minilabs-id/minicode/blob/main/vendor/minicore/VENDOR.md):
16
16
  `0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
17
17
 
18
18
  Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
@@ -41,9 +41,10 @@ dutinya:
41
41
 
42
42
  Kompaksi bersifat lossy, termasuk setelah restart. `persistCurrent` mengirim
43
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
44
+ menulis ulang baris `messages`; fold mekanis meringkas pesan lama sambil
45
+ **mempertahankan** hasil tool (head-terpotong per peran) — bukan membuangnya.
46
+ Ringkasan ke vector memory hanya dibuat di jalur LLM, dibatasi, opt-out, dan
47
+ best-effort. Karena itu jangan menganggap
47
48
  semua fakta lama tetap dapat dipulihkan dari sesi atau vector store; state
48
49
  penting harus dicatat di task, file, atau artefak verifikasi yang otoritatif.
49
50
 
@@ -119,18 +120,19 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
119
120
  | stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY |
120
121
  | Keduanya | Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe |
121
122
 
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.
123
+ 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; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. 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.
123
124
 
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).
125
+ Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
125
126
 
126
127
  ## Modul kunci
127
128
 
128
129
  - `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.
129
130
 
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`.
131
+ - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `ledger.ts` (status word/glyph/paint + run-marker bersama untuk TUI & linear), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `cells.ts` (framebuffer sel grapheme+SGR + diff "tulis-ulang ekor" untuk penulisan inkremental), `composer-wrap.ts` (wrap composer inkremental), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
131
132
  - `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`.
133
+ - `src/policy/`: `context.ts` (estimator sadar-densitas kode/JSON + kalibrasi usage), `context-window.ts` + `context-window-catalog.ts` (resolve window: config → katalog → models.dev → default 128K alias → 32K), `bpe.ts` + `tokenizer-registry.ts` (tokenizer BPE presisi on-demand dari HuggingFace, cache lokal, fallback densitas), `compaction.ts` (kompaksi LLM + mekanikal, anti-drift/anti-thrash, prefer provider sesi), `usage.ts`/`pricing.ts` (estimas biaya + models.dev).
132
134
  - `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).
133
- - `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
135
+ - `src/ui/screens/`: view murni `picker/wizard/model-manager/provider-manager`.
134
136
  - `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
135
137
  - `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
136
138
  - `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
@@ -0,0 +1,142 @@
1
+ # Autonomous Scheduler (eksperimental)
2
+
3
+ > **Eksperimental.** Opt-in per invokasi, nonaktif secara bawaan, dan dipicu manual.
4
+ > Tidak ada timer latar (no background timer). Tidak ada yang berjalan kecuali Anda memintanya.
5
+
6
+ Scheduler mengevaluasi task graph Anda dan, bila ada task yang siap, menyerahkannya
7
+ ke sesi MiniCode otonom yang mengerjakannya tanpa Anda.
8
+
9
+ ## 1. Aktifkan
10
+
11
+ Tambahkan flag ke sembarang invokasi:
12
+
13
+ ```bash
14
+ minicode --enable-scheduler
15
+ ```
16
+
17
+ Itu satu-satunya cara menyalakannya. Tidak ada kunci config, tidak ada variabel
18
+ environment, dan tidak ada cara mewarisinya dari proses induk — flag yang diketik
19
+ di baris perintah adalah satu-satunya mekanismenya. `--enable-scheduler=false`
20
+ **tidak** mengaktifkannya; flag tidak punya bentuk nilai, dan bare flag adalah
21
+ satu-satunya bentuk yang dihitung.
22
+
23
+ Saat startup dengan flag, proses mengakuisisi lease eksklusif pada sesi Anda.
24
+ Bila proses lain sudah memegang lease itu, startup gagal dengan jelas alih-alih
25
+ menjalankan scheduler kedua di atas sesi yang sama.
26
+
27
+ ## 2. Picu
28
+
29
+ Penjadwalan bersifat **manual**. Tidak ada yang berjalan sendiri:
30
+
31
+ ```text
32
+ /scheduler run
33
+ ```
34
+
35
+ Ini menjalankan tepat satu siklus penjadwalan:
36
+
37
+ - baca ulang task graph,
38
+ - pilih satu task yang siap (bila ada),
39
+ - klaim secara durable,
40
+ - jalankan satu turn otonom di atasnya,
41
+ - laporkan hasilnya.
42
+
43
+ Bila tidak ada yang siap, siklus berakhir dengan `no task was ready` dan tidak ada
44
+ pekerjaan yang dibuat. Jika sebuah task menjadi siap *setelah* itu, ia tetap
45
+ pending sampai Anda menjalankan `/scheduler run` lagi. Tidak ada polling, tidak
46
+ ada timer, dan tidak ada perulangan latar — ini kontrak saat ini, bukan kelalaian.
47
+
48
+ Perintah menunggu siklus selesai, lalu mencetak hasilnya.
49
+
50
+ ## 3. Amati
51
+
52
+ ```text
53
+ /scheduler status
54
+ ```
55
+
56
+ Melaporkan state saat ini, sesi yang dimilikinya, apakah lease dipegang, counter
57
+ untuk proses ini, dan lima event lifecycle terakhir.
58
+
59
+ Anda akan melihat satu dari lima state:
60
+
61
+ | State | Artinya |
62
+ | --- | --- |
63
+ | `scheduler OFF` | Flag tidak diberikan. Tidak ada scheduler. |
64
+ | `scheduler ON, idle` | Aktif, memegang lease, menunggu `/scheduler run`. |
65
+ | `scheduler ON, executing` | Sebuah siklus sedang berjalan. |
66
+ | `scheduler ON but STOPPED` | Dihentikan, dimatikan, atau lease-nya hilang. Tidak akan menjadwalkan lagi di proses ini. |
67
+ | `scheduler ON, last cycle failed` | Siklus gagal. Alasannya ada di baris berikutnya. |
68
+
69
+ Event lifecycle juga muncul inline di transkrip sebagai baris `[scheduler] ...`.
70
+ Itu entri sistem, bukan percakapan — tidak pernah dikirim ke model dan tidak
71
+ pernah muncul sebagai output tool.
72
+
73
+ Aktivitas bersifat in-memory dan reset saat proses keluar. State task yang
74
+ durable bertahan; diagnostik tidak.
75
+
76
+ ## 4. Hentikan
77
+
78
+ ```text
79
+ /scheduler stop
80
+ ```
81
+
82
+ Ini mencegah trigger berikutnya, mencegah klaim baru, membatalkan turn otonom
83
+ yang masih berjalan, dan melepas lease sesi agar proses lain bisa mengambilnya.
84
+
85
+ Menghentikan dua kali tidak masalah — panggilan kedua menyatakannya dan tidak
86
+ melakukan apa-apa.
87
+
88
+ Sekali dihentikan, scheduler tidak bisa di-start ulang. **Keluar dan mulai proses
89
+ baru** dengan flag untuk menjadwalkan lagi. Tidak ada toggle in-app karena alasan
90
+ yang sama `/scheduler stop` satu arah: menghentikan turn yang berjalan adalah
91
+ shutdown, bukan pengaturan.
92
+
93
+ ## 5. Pulihkan
94
+
95
+ Bila sebuah proses mati sambil memegang lease, lease tidak dilepas. Penggantinya
96
+ cukup menunggu:
97
+
98
+ - durasi lease 5 menit
99
+ - diperbarui tiap menit selama proses hidup
100
+
101
+ Jadi scheduler yang crash membebaskan sesinya otomatis dalam 5 menit. Untuk
102
+ memulihkan segera, hapus sesinya (`/sessions`), yang membatalkannya langsung.
103
+
104
+ Bila lease hilang saat berjalan (proses lain mengambil alih, atau sesi dihapus),
105
+ scheduler **self-dispose**. Ia tidak akan mengklaim atau mengeksekusi apa pun
106
+ lagi, dan alasannya muncul di `/scheduler status`. Ini disengaja: scheduler yang
107
+ tidak bisa membuktikan kepemilikan sesi lebih baik tidak berbuat apa-apa daripada
108
+ balapan dengan proses yang bisa.
109
+
110
+ ## 6. Nonaktifkan
111
+
112
+ Tidak ada yang perlu dimatikan. Hapus flag dan proses berikutnya tidak punya
113
+ scheduler sama sekali — tanpa lease, tanpa store handle, tanpa resource latar.
114
+ Menghentikan yang sedang berjalan: `/scheduler stop`, atau cukup keluar.
115
+
116
+ ## Yang boleh dilakukan sesi otonom
117
+
118
+ Turn otonom berjalan di bawah kebijakan **read-only**. Set tool adalah allow-list
119
+ tetap berisi kapabilitas read-only — baca file, search, inspeksi git, query LSP.
120
+ Tulis, edit, eksekusi, dan apa pun yang mengambil network ditolak, dan tidak ada
121
+ yang bisa memperlebar di jalur trigger: allow-list ditegakkan saat executor
122
+ dibangun, sehingga konfigurasi yang mencoba memperlebar gagal di startup alih-alih
123
+ berjalan dengan lebih banyak kekuatan.
124
+
125
+ Turn otonom tidak meminta persetujuan. Tidak ada operator di loop, itulah sebabnya
126
+ kebijakannya sempit, bukan permisif.
127
+
128
+ ## Batasan
129
+
130
+ - Satu siklus per `/scheduler run`; tanpa penjadwalan berulang.
131
+ - Tanpa langkah persetujuan antara klaim dan eksekusi. Kebijakan readonly adalah
132
+ batasnya.
133
+ - Diagnostik per-proses dan hilang saat keluar.
134
+ - Dua proses tidak bisa menjadwalkan sesi yang sama sekaligus; yang kedua gagal
135
+ tertutup.
136
+ - Eksperimental. Antarmukanya bisa berubah.
137
+
138
+ ## Terkait
139
+
140
+ - [CLI](cli.md) — referensi lengkap flag.
141
+ - [Arsitektur](architecture.md) — di mana scheduler berada.
142
+ - [Open Work](P14_OPEN_WORK.md) — pekerjaan lintas sesi yang diteruskan scheduler.
@@ -2,11 +2,11 @@
2
2
 
3
3
  Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
4
4
 
5
- 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/plánning), `BUILD` (implementasi).
5
+ 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/perencanaan), `BUILD` (implementasi).
6
6
  2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
7
7
  3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
8
8
 
9
- Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya.
9
+ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya — **kecuali mode `unrestricted`** (lihat baris terakhir tabel).
10
10
 
11
11
  ## Kalau tujuan Anda X → gunakan Y
12
12
 
@@ -18,6 +18,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
18
18
  | Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
19
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
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
+ | Full akses tanpa pembatas (VM/VPN tepercaya) | `/unrestric` (perintah TUI tersembunyi, per-sesi) | Melepas jail + bash-guard + sandbox/allowlist; gerbang = kepercayaan operator; gembok footer jadi 🔓 terang (bukan redup) |
21
22
 
22
23
  ## Rule of thumb
23
24
 
@@ -26,6 +27,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
26
27
  3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
27
28
  4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
28
29
  5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
30
+ 6. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — full akses berarti model bisa menyentuh file apa pun di host. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
29
31
 
30
32
  ## Tradeoff yang jujur
31
33
 
package/docs/cli.md CHANGED
@@ -24,7 +24,7 @@ Semua cara menjalankan Minicode: interaktif, sekali jalan, pipe, dan otomasi CI
24
24
  | `minicode skills list` | Daftar skill terpasang |
25
25
  | `minicode sessions list` | Riwayat sesi |
26
26
  | `minicode memory status [--json]` | Statistik vector RAG (rows, size, hit-rate) |
27
- | `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only; tidak menghapus) |
27
+ | `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only, bersihkan baris superseded; hierarki `MEMORY.md` root/`CLAUDE.md` tak disentuh) |
28
28
  | `minicode doctor [--json]` | Diagnosis lokal |
29
29
  | `minicode mcp serve` | Ekspos minicode sebagai MCP server |
30
30
  | `minicode openwork [inventory\|context\|export\|merge]` | Baca, susun konteks, ekspor, atau deduplikasi pekerjaan lintas sesi; aksi tidak menjalankan task |
@@ -51,7 +51,7 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
51
51
  | `--model <name>` | Override model (`providerId::model` paksa provider) |
52
52
  | `--provider <id>` | Paksa provider id agnostik |
53
53
  | `--resume <id>` | Lanjutkan history yang tersimpan; setelah kompaksi, bagian lama dapat berupa ringkasan + tail |
54
- | `--timeout <ms>` | Hard deadline per prompt (default 900000; 0 = Infinity). Sesi yang idle tidak menghabiskan deadline prompt berikutnya. |
54
+ | `--timeout <ms>` | Hard deadline per prompt (default 3600000 = 1 jam; `0` = Infinity; jalur `exec` tetap 15 menit). Sesi yang idle tidak menghabiskan deadline prompt berikutnya. |
55
55
  | `--cwd <path>` | Workspace root untuk tool file & jail |
56
56
  | `--allow-local-config` | Percayai `.minicode/config.json` + allowlist lokal (default: diabaikan) |
57
57
  | `--max-steps <n>` | Batas langkah tool (default 50) |
@@ -63,11 +63,13 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
63
63
 
64
64
  Tanpa flag, MiniCode memakai `providers[].contextWindows` dari konfigurasi.
65
65
  Jika model/gateway tidak punya metadata itu, MiniCode memakai fallback
66
- 32.000 token dan memberi peringatan saat sesi mulai. Gunakan batas model yang
67
- tepat pada config atau flag; batas yang terlalu kecil memicu kompaksi dini,
68
- sedangkan batas yang terlalu besar berisiko ditolak provider. Batas berubah
69
- otomatis saat `/model` mengganti model. MiniCode juga membatasi keluaran stream
70
- berdasarkan ruang tersisa setelah system prompt, tools, dan riwayat dihitung.
66
+ 32.000 token (model tak dikenal) atau default konservatif 128K untuk alias
67
+ router (`auto`/`best`/...), lalu memberi peringatan saat sesi mulai. Gunakan
68
+ batas model yang tepat pada config atau flag; batas yang terlalu kecil memicu
69
+ kompaksi dini, sedangkan batas yang terlalu besar berisiko ditolak provider.
70
+ Batas berubah otomatis saat `/model` mengganti model. MiniCode juga membatasi
71
+ keluaran stream berdasarkan ruang tersisa setelah system prompt, tools, dan
72
+ riwayat dihitung.
71
73
 
72
74
  Di TUI, **Tab** memutar Work Mode (`Discuss` → `Plan` → `Build`) dan **Shift+Tab** meng-toggle Permission Mode (`Auto` ↔ `Ask`). `/mode <AUTO|ASK>` mengubah persetujuan; `/work-mode <DISCUSS|PLAN|BUILD>` mengubah operating mode. Footer menampilkan Work Mode di kiri dan Permission Mode berwarna cyan di kanan, dekat penggunaan konteks; pada terminal sempit label dipadatkan.
73
75
 
@@ -115,7 +117,7 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
115
117
 
116
118
  ## Anti-injeksi flag
117
119
 
118
- `cli/args.ts:59-67` berhenti di prompt word pertama: prompt `"review --allow-all"` tidak mengaktifkan flag. `--cwd`/value-flag setelah nama subcommand diparse per-subcommand agar tidak menembus boundary prompt.
120
+ `cli/args.ts` (`hasFlag`/`getArg`) berhenti di prompt word pertama: prompt `"review --allow-all"` tidak mengaktifkan flag. `--cwd`/value-flag setelah nama subcommand diparse per-subcommand agar tidak menembus boundary prompt.
119
121
 
120
122
  ## Exit codes
121
123
 
@@ -123,6 +125,6 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
123
125
  |---|---|
124
126
  | `0` | Sukses, atau help yang memang diminta |
125
127
  | `1` | Gagal runtime: provider error, budget lewat, turn gagal, setup gagal |
126
- | `2` | Salah pakai: argumen hilang/malformed, subcommand asing |
128
+ | `2` | Salah pakai: argumen hilang/malformed, subcommand bersarang asing (token top-level asing malah jadi prompt one-shot) |
127
129
 
128
130
  Lookup yang gagal (provider/skill/sesi tak dikenal) = `1`: itu kegagalan operasi, bukan pemakaian. Skrip cukup cek `!= 0` untuk gagal; cek `== 2` untuk spesifik salah pakai.
package/docs/concepts.md CHANGED
@@ -12,12 +12,12 @@ Minicode itu apa, kenapa dibangun begitu, dan kenapa beberapa hal sengaja tidak
12
12
 
13
13
  ## Loop ReAct
14
14
 
15
- Setiap prompt berjalan sebagai loop `Thought → Action → Observation` sampai jawaban final, batas `--max-steps` (default 50), atau `--timeout` (default 15 menit). Model menerima system prompt berisi `# Environment` (cwd + platform), repo-map ringkas, dan memory yang relevan — lalu memilih tool, melihat hasilnya, dan memilih langkah berikutnya. Tidak ada grafik alur tersembunyi: apa pun yang agent lakukan tampil sebagai ledger di layar.
15
+ Setiap prompt berjalan sebagai loop `Thought → Action → Observation` sampai jawaban final, batas `--max-steps` (default 50), atau `--timeout` (default 1 jam). Model menerima system prompt berisi `# Environment` (cwd + platform), repo-map ringkas, dan memory yang relevan — lalu memilih tool, melihat hasilnya, dan memilih langkah berikutnya. Tidak ada grafik alur tersembunyi: apa pun yang agent lakukan tampil sebagai ledger di layar.
16
16
 
17
17
  ## Shell-first: non-interaktif polos, interaktif fullscreen
18
18
 
19
- Minicode sengaja **tanpa framework TUI** (tanpa Ink/React, tanpa panel
20
- permanen) dan membagi dua jalur secara tegas:
19
+ Minicode sengaja **tanpa library TUI pihak ketiga** (tanpa Ink/React; TUI-nya
20
+ ditulis sendiri) dan membagi dua jalur secara tegas:
21
21
 
22
22
  - **Non-interaktif** (one-shot prompt, `exec`, pipe/redirect/CI, `TERM=dumb`):
23
23
  output mengalir **append-only ke scrollback** — hasil agen adalah artefak
@@ -35,8 +35,8 @@ Detail lengkap + kontrak FROZEN-nya di [Kontrak Terminal](terminal.md).
35
35
  Beberapa keputusan desain lahir dari tidak mau berpura-pura:
36
36
 
37
37
  - **Angka tidak ditulis permanen** di dokumentasi — jalankan `bun test` / `bun run gate:coverage` / lihat CI. Halaman yang mengklaim jumlah test akan usang begitu dipush.
38
- - **Kegagalan dilaporkan apa adanya**: `auth login` menampilkan error server tanpa dipercantik; `--sync` jujur `{updated, failed}`; sandbox yang tidak tersedia **tidak** dilabeli aman — default turun ke `allowlist` dengan alasan dicetak sekali.
39
- - **Ukur, bukan klaim**: bash-guard divalidasi korpus serangan + fuzz ber-seed (jalankan `bun run gate:bash` / `bun run extreme:fuzz`). Lihat [Keamanan](security.md).
38
+ - **Kegagalan dilaporkan apa adanya**: `auth login` menampilkan error server tanpa dipercantik; `minicode sync`/`/sync` jujur `{updated, failed}`; sandbox yang tidak tersedia **tidak** dilabeli aman — default turun ke `allowlist` dengan alasan dicetak sekali.
39
+ - **Ukur, bukan klaim**: bash-guard divalidasi korpus serangan + perintah sah (jalankan `bun run gate:bash`). Lihat [Keamanan](security.md).
40
40
  - **Skor benchmark dilaporkan apa adanya** beserta batas validitasnya (lingkungan, ukuran sampel). Lihat [Verify & Benchmark](verify-benchmark.md).
41
41
 
42
42
  ## Zero-dep runtime