minicode-ai 0.15.0 → 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 (99) hide show
  1. package/README.md +6 -4
  2. package/cli/commands/exec.ts +3 -2
  3. package/cli/commands/openwork.ts +1 -1
  4. package/cli/commands.ts +6 -6
  5. package/cli/index.ts +4 -4
  6. package/cli/model-manager.ts +1 -1
  7. package/cli/setup.ts +57 -30
  8. package/cli/tui.ts +106 -11
  9. package/docs/CONTROL-PLANE-MAP.md +6 -4
  10. package/docs/OUTPUT_EVENT_MODEL.md +4 -3
  11. package/docs/OUTPUT_PROTOCOL_SPEC.md +1 -1
  12. package/docs/OUTPUT_RENDERING_SPEC.md +16 -4
  13. package/docs/OUTPUT_UX_RULES.md +38 -32
  14. package/docs/P14_OPEN_WORK.md +290 -0
  15. package/docs/README.md +1 -1
  16. package/docs/SUMMARY.md +36 -22
  17. package/docs/TERMINAL_CONTRACT.md +54 -7
  18. package/docs/UI_RENDER_PIPELINE.md +47 -8
  19. package/docs/agents.md +1 -1
  20. package/docs/architecture.md +9 -8
  21. package/docs/autonomous-scheduler.md +142 -0
  22. package/docs/choosing-mode.md +2 -2
  23. package/docs/cli.md +4 -4
  24. package/docs/concepts.md +5 -5
  25. package/docs/config-providers.md +3 -3
  26. package/docs/contributing.md +7 -9
  27. package/docs/environment.md +5 -4
  28. package/docs/getting-started.md +4 -4
  29. package/docs/mcp-lsp.md +2 -2
  30. package/docs/memory-sessions.md +1 -1
  31. package/docs/policy-sandbox.md +7 -4
  32. package/docs/pricing-budget.md +3 -3
  33. package/docs/quickstart.md +1 -1
  34. package/docs/repl.md +5 -5
  35. package/docs/security-model.md +1 -1
  36. package/docs/security.md +9 -8
  37. package/docs/skills.md +2 -2
  38. package/docs/terminal.md +10 -2
  39. package/docs/tools.md +4 -4
  40. package/docs/troubleshooting.md +3 -3
  41. package/docs/verify-benchmark.md +0 -3
  42. package/package.json +9 -18
  43. package/src/app/session.ts +40 -7
  44. package/src/constants.ts +31 -0
  45. package/src/hooks/run.ts +5 -6
  46. package/src/mcp/http-transport.ts +1 -1
  47. package/src/policy/bash-guard.ts +26 -6
  48. package/src/policy/compaction.ts +107 -17
  49. package/src/policy/consequence-engine.ts +3 -3
  50. package/src/policy/context-window.ts +24 -1
  51. package/src/policy/context.ts +16 -4
  52. package/src/policy/permission.ts +219 -4
  53. package/src/presentation/adapter.ts +1 -1
  54. package/src/presentation/events.ts +2 -2
  55. package/src/presentation/label.ts +3 -3
  56. package/src/presentation/model.ts +4 -0
  57. package/src/presentation/store.ts +2 -2
  58. package/src/runtime/child-execution.ts +1 -1
  59. package/src/runtime/composition.ts +5 -5
  60. package/src/runtime/execution-registry.ts +1 -1
  61. package/src/runtime/production-execution.ts +3 -3
  62. package/src/runtime/production-runtime.ts +2 -2
  63. package/src/runtime/runtime-capabilities.ts +1 -1
  64. package/src/runtime/runtime-status-facts.ts +1 -1
  65. package/src/runtime/runtime-task-admission.ts +2 -2
  66. package/src/session/context-assembly.ts +8 -1
  67. package/src/session/context-identity.ts +2 -2
  68. package/src/session/context-projection.ts +36 -11
  69. package/src/session/persistence.ts +1 -1
  70. package/src/task/autonomous-context.ts +2 -2
  71. package/src/task/autonomous-policy.ts +3 -3
  72. package/src/task/model.ts +2 -2
  73. package/src/task/production-scheduler.ts +2 -2
  74. package/src/task/scheduler.ts +3 -2
  75. package/src/task/scheduling-policy.ts +2 -1
  76. package/src/task/trigger.ts +5 -5
  77. package/src/tools/read_image.ts +2 -1
  78. package/src/tools/task.ts +1 -1
  79. package/src/ui/assistant/simple.ts +33 -30
  80. package/src/ui/footer.ts +48 -9
  81. package/src/ui/i18n/en.ts +1 -0
  82. package/src/ui/i18n/id.ts +1 -0
  83. package/src/ui/input/prompt-engine.ts +36 -10
  84. package/src/ui/render/cells.ts +320 -0
  85. package/src/ui/render/composer-wrap.ts +73 -0
  86. package/src/ui/render/detail.ts +2 -2
  87. package/src/ui/render/ledger.ts +47 -0
  88. package/src/ui/render/theme.ts +32 -4
  89. package/src/ui/render/width.ts +2 -2
  90. package/src/ui/render/wrap.ts +5 -3
  91. package/src/ui/runtime/screen.ts +84 -7
  92. package/src/ui/runtime/statusline.ts +26 -0
  93. package/src/ui/screens/model-manager.ts +1 -1
  94. package/src/ui/tui/app.ts +336 -65
  95. package/src/ui/tui/transcript.ts +247 -88
  96. package/vendor/minicore/VENDOR.md +15 -11
  97. package/vendor/minicore/src/core/events.ts +1 -0
  98. package/vendor/minicore/src/core/loop.ts +10 -0
  99. package/vendor/minicore/src/core/session.ts +39 -0
@@ -1,4 +1,14 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.11, 2026-11-09)
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).
2
12
 
3
13
  Perubahan v7.11: thinking & jawaban di TUI dan renderer linear kini membungkus di
4
14
  batas kata (`wrapByWidth`) — tidak memotong di tengah kata — dan baris diff ikut
@@ -209,7 +219,23 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
209
219
  ## Invariant (nomor dipakai di peta proteksi)
210
220
 
211
221
  1. Satu tampilan interaktif: TUI fullscreen; frame penuh tiap repaint (tepat
212
- `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.
213
239
  2. stdout/stderr contract seperti tabel di atas (TTY & non-TTY deterministic).
214
240
  3. Satu kepemilikan layar (`App`); popup satu lifecycle (`suspend`/`resume` +
215
241
  `paintRegion`).
@@ -233,6 +259,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
233
259
 
234
260
  13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
235
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).
236
268
  Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
237
269
  bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
238
270
  Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
@@ -273,7 +305,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
273
305
  saat turn). Composer memakai tinggi tetap: prompt saat editing, dots saat
274
306
  reasoning, atau tool target; satu baris kosong selalu memisahkannya dari
275
307
  footer. Proyeksi presentasi: baris running di-pin dari snapshot, elapsed
276
- tetap pada ledger tool, status tool final memakai glyph + kata
308
+ tetap pada ledger tool, status tool final memakai warna + kata
277
309
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
278
310
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
279
311
  **Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
@@ -459,7 +491,7 @@ status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission
459
491
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
460
492
  dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
461
493
  + satu spacer sebelum footer · ledger tool
462
- ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
494
+ ` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
463
495
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
464
496
  `src/ui/render/errors.ts`): credential di-redaksi (bearer/key/query), escape
465
497
  ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
@@ -468,11 +500,11 @@ belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
468
500
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
469
501
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
470
502
  `/fold` = lipat aktivitas tool per turn (`MINICODE_MINIMIZE_ACTIVITY`, ON di TUI) —
471
- baris ledger per-tool dirangkum jadi SATU baris ringkas (`✓ n tools · nama · x ok · y gagal`),
503
+ baris ledger per-tool dirangkum jadi SATU baris ringkas (`n tools · nama · x ok · y gagal`),
472
504
  tidak hilang diam-diam; detail dibuka via `/expand` ·
473
505
  tabel markdown dirender kotak ber-garis (opencode-like) ber-`wrap` (konten panjang
474
506
  tidak kepotong) + margin kiri 1 kolom; teks paragraf ber-margin kiri 1 kolom ·
475
- Projection V2: `› name target … running`, ledger status ber-glyph/kata,
507
+ Projection V2: `› name target … running`, ledger status ber-warna/kata,
476
508
  retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
477
509
  identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
478
510
  sesuai flag ·
@@ -578,6 +610,9 @@ panjang).
578
610
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
579
611
  stdout-pipe tanpa sink = deny).
580
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).
581
616
  - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
582
617
  dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
583
618
  yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
@@ -640,7 +675,19 @@ panjang).
640
675
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
641
676
  - `test/cli-commands.test.ts` — /status cetak, /sessions popup.
642
677
  - `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
643
- 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).
644
691
  - `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
645
692
  yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
646
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,19 +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`.
132
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).
133
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).
134
- - `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
135
+ - `src/ui/screens/`: view murni `picker/wizard/model-manager/provider-manager`.
135
136
  - `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
136
137
  - `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
137
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,7 +2,7 @@
2
2
 
3
3
  Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
4
4
 
5
- 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/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
 
@@ -18,7 +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 🔓 gelap |
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) |
22
22
 
23
23
  ## Rule of thumb
24
24
 
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) |
@@ -117,7 +117,7 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
117
117
 
118
118
  ## Anti-injeksi flag
119
119
 
120
- `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.
121
121
 
122
122
  ## Exit codes
123
123
 
@@ -125,6 +125,6 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
125
125
  |---|---|
126
126
  | `0` | Sukses, atau help yang memang diminta |
127
127
  | `1` | Gagal runtime: provider error, budget lewat, turn gagal, setup gagal |
128
- | `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) |
129
129
 
130
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
@@ -1,6 +1,6 @@
1
1
  # Config & Provider
2
2
 
3
- ## 14 preset gateway
3
+ ## 15 preset gateway (termasuk Custom URL)
4
4
 
5
5
  `Gateway >` hanya menampilkan `[0] Label` tanpa URL (minimalis, tanpa bocor endpoint).
6
6
 
@@ -39,7 +39,7 @@ minicode auth logout qwen
39
39
 
40
40
  Token di `~/.minicode/auth.json` (chmod 600), bukan `config.json`. Refresh otomatis margin 60 dtk. Provider OAuth yang belum login dibuang dari daftar dengan peringatan, bukan dikirim dengan header kosong.
41
41
 
42
- > Kejujuran: device flow teruji lengkap ke server OAuth lokal (18 test: pending/slow_down/denied/expired/clamp), tapi endpoint/clientId provider belum semua terkonfirmasi live. `auth login chatgpt` fail-fast di non-TTY. Jangan baca token aplikasi desktop orang lain — itu pencurian kredensial.
42
+ > Kejujuran: device flow teruji lengkap ke server OAuth lokal (pending/slow_down/denied/expired/clamp), tapi endpoint/clientId provider belum semua terkonfirmasi live. `auth login chatgpt` fail-fast di non-TTY. Jangan baca token aplikasi desktop orang lain — itu pencurian kredensial.
43
43
 
44
44
  ## Keyring OS (ganti plaintext config)
45
45
 
@@ -58,7 +58,7 @@ Enter → pilih model (+ picker effort bila modelnya mendukung)
58
58
  Esc → batal total
59
59
  ```
60
60
 
61
- Effort tersimpan di `ProviderEntry.reasoningEffort`, berlaku sesi berikutnya, tampil badge `[low|medium|high]`. **Default universal = omit** (tanpa param thinking): default bawaan tiap model sudah di-tune vendornya. Knob hanya dikirim ke keluarga terbukti, dalam bahasa native-nya: OpenAI reasoning (`o*`, `gpt-5/6` → `reasoning_effort`, level tervalidasi per model — pro = high saja); Claude ≤4.5 → budget `1024/2048/4096`; Claude ≥4.6/5 → adaptive + `output_config.effort`. **Selain itu tak pernah dikirimi param thinking** (DeepSeek, Gemini, Groq, Ollama, free-tier, custom). Bila model menolak param (400/500), request diulang sekali tanpa param + diingat per sesi + dicatat `[thinking]` di stderr. Picker effort hanya muncul untuk model yang mendukung; sisanya select langsung tanpa menyentuh effort tersimpan. `detectAndSave`/`auth login` mempertahankan effort (tidak reset diam-diam). Mutasi ditulis ke file scope asal (bukan hasil merge) agar tidak duplikat/shadowing.
61
+ Effort tersimpan di `ProviderEntry.reasoningEffort`, berlaku sesi berikutnya, tampil badge `[low|medium|high]`. **Default universal = omit** (tanpa param thinking): default bawaan tiap model sudah di-tune vendornya. Knob hanya dikirim ke keluarga terbukti, dalam bahasa native-nya: OpenAI reasoning (`o1`/`o3`/`o4`, `gpt-5`/`gpt-6` → `reasoning_effort`, level tervalidasi per model — pro = high saja); Claude ≤4.5 → budget `1024/2048/4096`; Claude ≥4.6/5 → adaptive + `output_config.effort`. **Selain itu tak pernah dikirimi param thinking** (DeepSeek, Gemini, Groq, Ollama, free-tier, custom). Bila model menolak param (400/500), request diulang sekali tanpa param + diingat per sesi + dicatat `[thinking]` di stderr. Picker effort hanya muncul untuk model yang mendukung; sisanya select langsung tanpa menyentuh effort tersimpan. `detectAndSave`/`auth login` mempertahankan effort (tidak reset diam-diam). Mutasi ditulis ke file scope asal (bukan hasil merge) agar tidak duplikat/shadowing.
62
62
 
63
63
  Model override sekali jalan:
64
64
 
@@ -5,7 +5,7 @@ Lisensi **MIT** (lihat `LICENSE`). Kontribusi publik diterima. Praktik aktif: **
5
5
  ## Setup dev
6
6
 
7
7
  ```bash
8
- git clone https://github.com/startupmini/minicode && cd minicode
8
+ git clone https://github.com/minilabs-id/minicode && cd minicode
9
9
  bun install
10
10
  bun test # offline/hermetic; live & docker di-skip otomatis
11
11
  bun x tsc --noEmit
@@ -39,24 +39,22 @@ Coverage naik → naikkan minimum di `scripts/coverage-gate.ts` (per 2026-10-25:
39
39
 
40
40
  ```bash
41
41
  bun run gate:fast # tsc + lint + test + coverage + pack + bash + bench:smoke + audit:harness (per-commit/CI)
42
- bun run gate:slow # extreme fuzz + shadow-git stress + MCP adversarial (nightly slow.yml + manual)
43
42
  ```
44
43
 
45
- Lambat/stokastik (fuzz multi-seed, stress, docker) tinggal di `slow.yml` — kegagalannya sinyal investigasi, bukan penolakan PR. CI per-commit (`ci.yml`) hanya menjalankan yang deterministik.
44
+ Gerbang lambat/stokastik (docker sandbox) tinggal di `slow.yml` — kegagalannya sinyal investigasi, bukan penolakan PR. CI per-commit (`ci.yml`) hanya menjalankan yang deterministik.
46
45
 
47
- ### Budget ukuran paket (3.920 KiB)
46
+ ### Budget ukuran paket (3.968 KiB)
48
47
 
49
- `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.920 KiB (3,83 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
48
+ `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.968 KiB (3,875 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
50
49
 
51
- Batas 3.920 KiB disetujui pemilik pada 2026-11-05 untuk rilis v0.14.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
50
+ Batas 3.968 KiB disetujui pemilik pada 2026-11-10 untuk rilis v0.17.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
52
51
 
53
52
  Gerbang lain:
54
53
 
55
54
  ```bash
56
55
  bun run gate:bash # 62 pola serangan + 24 perintah sah → 0 bypass / 0 over-block
57
- bun run extreme # fuzz + shadow-git + MCP jahat
58
56
  bun run bench:smoke # fake, CI-safe
59
- bun run vendor:check # source MiniCore + overlay host cocok dengan vendor
57
+ bun run vendor:check # provenance MiniCore (soft; vendor host-editable sejak v0.16.0)
60
58
  ```
61
59
 
62
60
  ## Batas lapisan (dijaga `test/ui-boundary.test.ts`)
@@ -65,7 +63,7 @@ bun run vendor:check # source MiniCore + overlay host cocok dengan vendor
65
63
  - Lintas-lapisan via DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `ask`, `setupWhenEmpty`, `setSubAgentSessionFactory`. Tanpa injeksi default selalu deny / fail-closed.
66
64
  - `providers → config` satu arah (provisioning di `src/providers/provision.ts`, `src/config.ts` murni IO).
67
65
  - Layar `src/ui/screens/` = view murni (props + callback), controller di `cli/`.
68
- - Jalur non-interaktif shell-first (append-only scrollback); sesi interaktif SELALU TUI alternate-screen (kontrak I16, tanpa opsi linear).
66
+ - Jalur non-interaktif shell-first (append-only scrollback); sesi interaktif SELALU TUI alternate-screen (invariant terminal #1, tanpa opsi linear).
69
67
  - Ubah struktur/dependensi antarlapisan → wajib update `docs/architecture.md`.
70
68
 
71
69
  ## Aturan kode