minicode-ai 0.23.0 → 0.26.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 (104) hide show
  1. package/README.md +5 -3
  2. package/cli/commands/config.ts +123 -0
  3. package/cli/setup.ts +107 -8
  4. package/cli/tui.ts +28 -2
  5. package/docs/README.md +2 -2
  6. package/docs/SUMMARY.md +10 -19
  7. package/docs/TERMINAL_CONTRACT.md +113 -28
  8. package/docs/architecture.md +1 -1
  9. package/docs/autonomous-scheduler.md +283 -2
  10. package/docs/choosing-mode.md +4 -4
  11. package/docs/concepts.md +39 -3
  12. package/docs/config.md +103 -5
  13. package/docs/environment.md +4 -0
  14. package/docs/getting-started.md +69 -5
  15. package/docs/repl.md +1 -1
  16. package/docs/security.md +49 -2
  17. package/docs/tools.md +2 -1
  18. package/package.json +2 -36
  19. package/src/app/provider-layer.ts +1 -1
  20. package/src/app/session.ts +187 -17
  21. package/src/config.ts +21 -8
  22. package/src/constants.ts +17 -1
  23. package/src/lib/net.ts +6 -15
  24. package/src/lib/public-http.ts +128 -0
  25. package/src/lib/safe-open.ts +21 -12
  26. package/src/memory/vector.ts +0 -31
  27. package/src/policy/auto-resume.ts +63 -0
  28. package/src/policy/compaction.ts +354 -70
  29. package/src/policy/context-budget.ts +4 -6
  30. package/src/policy/context-window-assign.ts +114 -0
  31. package/src/policy/context-window-catalog.ts +4 -1
  32. package/src/policy/context-window-presets.ts +165 -0
  33. package/src/policy/context-window.ts +19 -37
  34. package/src/policy/context.ts +11 -9
  35. package/src/policy/executor.ts +69 -27
  36. package/src/policy/microcompact.ts +76 -15
  37. package/src/policy/no-progress.ts +1 -1
  38. package/src/policy/permission.ts +5 -0
  39. package/src/policy/recovery-budget.ts +281 -0
  40. package/src/policy/scrub.ts +15 -2
  41. package/src/policy/step-escalation.ts +82 -0
  42. package/src/policy/tokenizer-registry.ts +1 -0
  43. package/src/policy/tool-contract.ts +11 -9
  44. package/src/presentation/reducer.ts +1 -0
  45. package/src/providers/anthropic.ts +3 -3
  46. package/src/providers/detect.ts +40 -7
  47. package/src/providers/provision.ts +23 -1
  48. package/src/runtime/child-execution.ts +4 -2
  49. package/src/runtime/execution-backend.ts +3 -0
  50. package/src/sandbox/os.ts +53 -9
  51. package/src/session/context-assembly.ts +11 -7
  52. package/src/session/persistence.ts +19 -3
  53. package/src/task/autonomous-policy.ts +7 -0
  54. package/src/task/graph-validate.ts +1 -1
  55. package/src/task/session-authority.ts +0 -5
  56. package/src/task/store.ts +0 -4
  57. package/src/tools/ask_user.ts +14 -1
  58. package/src/tools/bash.ts +68 -17
  59. package/src/tools/code_run.ts +19 -20
  60. package/src/tools/context.ts +10 -0
  61. package/src/tools/delete_file.ts +3 -2
  62. package/src/tools/edit.ts +5 -4
  63. package/src/tools/git.ts +70 -12
  64. package/src/tools/glob.ts +13 -5
  65. package/src/tools/grep.ts +26 -10
  66. package/src/tools/index.ts +3 -2
  67. package/src/tools/lsp.ts +15 -9
  68. package/src/tools/move_file.ts +4 -3
  69. package/src/tools/patch.ts +5 -4
  70. package/src/tools/read_file.ts +3 -2
  71. package/src/tools/read_image.ts +3 -2
  72. package/src/tools/task.ts +5 -1
  73. package/src/tools/todo.ts +4 -8
  74. package/src/tools/web_fetch.ts +13 -19
  75. package/src/tools/write_file.ts +4 -3
  76. package/src/ui/approval/prompt.ts +226 -77
  77. package/src/ui/assistant/simple.ts +61 -10
  78. package/src/ui/footer.ts +41 -29
  79. package/src/ui/i18n/en.ts +7 -0
  80. package/src/ui/i18n/id.ts +7 -0
  81. package/src/ui/input/prompt-engine.ts +53 -21
  82. package/src/ui/render/activity-group.ts +9 -0
  83. package/src/ui/render/activity-panel.ts +20 -2
  84. package/src/ui/render/ledger.ts +1 -9
  85. package/src/ui/render/logo.ts +0 -5
  86. package/src/ui/render/markdown-table.ts +0 -3
  87. package/src/ui/render/table-grid.ts +0 -3
  88. package/src/ui/render/theme.ts +31 -5
  89. package/src/ui/runtime/screen.ts +7 -1
  90. package/src/ui/screens/dialog.ts +45 -81
  91. package/src/ui/screens/form.ts +10 -10
  92. package/src/ui/screens/model-manager.ts +7 -10
  93. package/src/ui/screens/picker.ts +8 -11
  94. package/src/ui/screens/provider-manager.ts +9 -13
  95. package/src/ui/tui/app.ts +118 -20
  96. package/src/ui/tui/transcript.ts +179 -29
  97. package/vendor/minicore/src/core/loop.ts +20 -1
  98. package/vendor/minicore/src/core/session.ts +6 -0
  99. package/docs/P14_OPEN_WORK.md +0 -290
  100. package/docs/config-providers.md +0 -87
  101. package/docs/glossary.md +0 -39
  102. package/docs/quickstart.md +0 -60
  103. package/docs/security-model.md +0 -96
  104. package/docs/terminal.md +0 -91
@@ -1,4 +1,60 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.13, 2026-11-13)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.15, unreleased)
2
+
3
+ Perubahan v7.15 (remediasi audit): CSI/SS3 malformed dibuang sampai byte
4
+ independen berikutnya; Ctrl+C/Ctrl+D tetap dapat didekode. Prefix kontrol
5
+ tertahan dibatasi 64 byte. Sequence lengkap yang tidak didukung (termasuk
6
+ Ctrl+panah) menghasilkan `ignore`, bukan Escape; Escape tunggal tetap memakai
7
+ flush timer yang ada. Peta proteksi: `test/input-recovery.test.ts` dan
8
+ `test/prompt-engine.test.ts`. Cache proyeksi transkrip memakai ID baris stabil;
9
+ eviction hanya menghapus cache ID yang hilang, dengan geometri/output tetap.
10
+ Peta proteksi: `test/transcript-retention-cache.test.ts`.
11
+ Panel aktivitas tetap menghitung semua tool, tetapi error/deny/cancel/interrupted
12
+ juga tampil langsung sebagai ledger dengan nama tool dan alasan yang tersedia.
13
+ Hitungan denied/cancelled/interrupted dipisahkan dari failed dan tidak disembunyikan.
14
+ Peta proteksi: `test/activity-panel.test.ts`, `test/activity-fold.test.ts`.
15
+ Warning perbedaan kapasitas katalog/metadata menyatakan angka dan sumber yang dipakai;
16
+ metadata model eksak mengalahkan tebakan keluarga katalog, setelah override endpoint/operator.
17
+ Prinsip **satu baris per kejadian** (v7.15): satu turn menghasilkan satu baris
18
+ ringkasan thinking (angka baris diakumulasi lintas segmen, diperbarui di tempat —
19
+ bukan satu baris per segmen reasoning) dan satu baris ringkasan aktivitas tool;
20
+ panel aktivitas hidup tidak boleh meninggalkan salinan permanen 10 baris di
21
+ belakang setiap turn. Tinggi tata letak TUI tidak bergantung pada status
22
+ (indicators mengalah ke baris footer), sehingga transkrip tidak bergeser saat
23
+ thinking/tool berjalan. Alasan kegagalan ringkasan kompaksi dipendekkan ke
24
+ sebabnya (status + kode + pesan) tanpa payload JSON gateway.
25
+ Peta proteksi: `test/tui-render-regressions.test.ts`.
26
+
27
+
28
+ Perubahan v7.14: **geometri & dekorasi popup diseragamkan** (audit Surface
29
+ Popup, `AUD-001..AUD-011`). Empat perubahan tampak-pengguna:
30
+
31
+ 1. **Lebar kotak popup diskalakan, bukan angka tetap.** `popupBoxWidth(cols) =
32
+ min(max(40, min(88, floor(cols*0.6))), cols-4)` — dihitung saat *mount* lalu
33
+ **dibekukan** (min=max) agar geometri stabil, tetapi menyesuaikan terminal
34
+ tiap mount. I20 diperbarui. Margin 4 kolom **selalu menang** atas lantai
35
+ 40 (AUD-011).
36
+ 2. **Sudut kotak MELENGKUNG (`╭ ╮ ╰ ╯`) default.** Kill-switch:
37
+ `MINICODE_BOX=square` (`┌┐└┘`), `MINICODE_BOX=ascii`/`MINICODE_ASCII=1`
38
+ (`+-|`). Dibaca lazy tiap render.
39
+ 3. **Backdrop popup = scrim tiga tingkat** (`scrimMode()`):
40
+ `bg` = dim **+ latar `48;5;236`** (≥256 warna), `faint` = `\x1b[2m` saja
41
+ (16 warna), `none` = nol byte (mono/non-TTY/`TERM=dumb`). Reset SGR
42
+ dalam konten **memulihkan** scrim; bold **dinetralkan** ke scrim.
43
+ 4. **Kotak approval memakai lebar popup seragam**, bukan selebar layar
44
+ (AUD-007). Opsinya **navigasi daftar**: `↑↓`/`Home`/`End` + `Enter`,
45
+ `Esc` = deny. Ketik-cepat `y`/`a`/`n` (+ sinonim `ya`/`selalu`/`s`/`tidak`/
46
+ `t`) tetap berfungsi — I25 menuntut navigasi daftar, bukan dua langkah wajib.
47
+
48
+ `MINICODE_SCRIM=none` memaksa `faint` untuk diagnostik. Level warna juga
49
+ memakai `process.stdout.getColorDepth()` sesudah env (`COLORTERM`/`TERM`) agar
50
+ Windows Terminal/ConPTY yang tak mengisi `TERM` tetap dapat 256 warna/truecolor
51
+ (AUD-002). Non-TTY **tidak berubah**: 0 warna, 0 scrim, 0 byte (I6).
52
+
53
+ Peta proteksi baru: `test/surface-audit-regressions.test.ts` (AUD-007/008/010/011),
54
+ `test/dialog.test.ts` (glyph melengkung + kill-switch + geometri skala),
55
+ `test/tui-geometry.test.ts` (lebar beku per mount, bukan 64 tetap),
56
+ `test/ui-audit-regressions.test.ts` (AUD-003: bold dinetralkan, `[22m`
57
+ memulihkan scrim — diuji dengan TTY palsu agar `scrimMode() != none`).
2
58
 
3
59
  Perubahan v7.13: baris status kompaksi (`context:compacted`) kini **membedakan
4
60
  hasil** alih-alih mencetak `reason` mentah. Sebelumnya sesi yang konteksnya TIDAK
@@ -36,8 +92,10 @@ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
36
92
  (v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
37
93
 
38
94
  Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
39
- sebagai **ikon gembok** `🔒` di ujung footer (setelah Permission Mode), terang
40
- saat aktif (mode Auto + restrictBash) dan redup saat nonaktif. Sumbu persetujuan
95
+ sebagai **titik monokrom** `●` di ujung footer (setelah Permission Mode), kuning
96
+ saat aktif (mode Auto + restrictBash) dan abu saat nonaktif. Saat mode
97
+ `unrestricted` aktif, titik jadi `○` MERAH (terbuka) sebagai penanda satu-satunya.
98
+ Fallback ASCII `[LOCK]`/`[OPEN]` untuk terminal tanpa UTF-8. Sumbu persetujuan
41
99
  tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
42
100
  sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
43
101
  bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
@@ -57,9 +115,11 @@ command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
57
115
  model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
58
116
  ringkas.
59
117
 
60
- Perubahan v7.7: footer memakai label title case `Work Mode: Build` di sisi kiri
61
- dan `Permission Mode: Auto` di sisi kanan dekat pemakaian konteks. Nilai kedua
62
- mode memakai warna berbeda; pada terminal sempit label dipadatkan sebelum nilai
118
+ Perubahan v7.7 (diperbarui v0.24): footer menampilkan nilai Work Mode di sisi
119
+ kiri dan nilai Permission Mode di sisi kanan dekat pemakaian konteks. Label
120
+ `Work Mode:`/`Permission Mode:` dihapus agar footer satu baris lebih lega —
121
+ pembeda sumbu tinggal warna (Work Mode semantik, Permission Mode cyan). Nilai
122
+ kedua mode memakai title case; pada terminal sempit nilai dipadatkan sebelum
63
123
  mode atau konteks dihilangkan.
64
124
 
65
125
  Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
@@ -232,6 +292,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
232
292
  state.json `lang` > locale OS (`LANG`/`LC_ALL` awalan `id`) > en. Semua
233
293
  string user-visible TUI lewat `t()` — literal Indonesia hardcode di luar
234
294
  dict dilarang (test anti-regresi). Getter runtime, bukan const beku.
295
+ Bahasa balasan model (progres, pertanyaan, jawaban akhir) mengikuti bahasa
296
+ pesan pengguna atau permintaan bahasa eksplisit, termasuk saat berganti bahasa;
297
+ pesan pendek mengikuti bahasa percakapan yang sudah terbentuk. Locale UI/OS
298
+ dan `/lang` hanya mengatur label UI, bukan bahasa balasan. Kutipan, kode, log,
299
+ serta hasil tool bukan penentu bahasa pengguna. Peta proteksi prompt:
300
+ `test/context-audit.test.ts`; kepatuhan model perlu diuji dengan provider nyata.
235
301
  - **Keybinding konsisten** (kontrak I25): `Esc` dua-tahap di semua input
236
302
  teks; `backspace`/`delete` selalu edit teks (aksi hapus-data via `d`/
237
303
  `Del` + confirm dalam popup, tercatat); navigasi daftar = `↑↓` + `pgup/
@@ -295,19 +361,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
295
361
  live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
296
362
  layout paint tidak boleh memproyeksikan transcript dua kali.
297
363
 
298
- 13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
299
- context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
364
+ 13. Status bar: 1 baris dasar (`✦ 00.00.00 Discuss model cwd … context Auto`)
365
+ dari sumber yang sama dengan angka sesi.
300
366
  Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
301
367
  LIVE turn-store yang di-emit kernel per step (event `provider:extension`
302
368
  kind `context-window`, setelah `step:completed`); saat idle kembali ke
303
369
  `session.contextTokens` (committed store). Estimator tetap satu sumber —
304
370
  hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
305
371
  (beku), tak ada duplikasi angka sumber (v7.12).
306
- Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
307
- bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
308
- Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
309
- konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
310
- atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
372
+ Titik `●` mengikuti Permission Mode di ujung kanan: kuning bila bash
373
+ allow-list aktif (restrictBash + mode `Auto`), abu bila tidak; `○` merah
374
+ = mode `unrestricted` (fallback ASCII `[LOCK]`/`[OPEN]`). Work Mode berada
375
+ di kiri; Permission Mode cyan berada di kanan dekat konteks (label produk
376
+ `Work Mode:`/`Permission Mode:` dihapus pada v0.24 — nilai saja). Bila ada
377
+ job background hidup, badge `◷ N` (jam berputar pelan, `N` = jumlah job)
378
+ tampil di samping spark; fallback ASCII `[BG:N]`. `✦` tetap
311
379
  menjadi indikator proses hidup;
312
380
  timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
313
381
  detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
@@ -368,9 +436,18 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
368
436
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
369
437
  oldest-to-newest) melalui OSC 52.
370
438
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
371
- 20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 64,
372
- form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
373
- selalu tampil.
439
+ 20. Lebar kotak popup **diskalakan dari lebar layar dan DIBEKUKAN saat mount**:
440
+ `popupBoxWidth(cols) = min(max(40, min(88, floor(cols*0.6))), cols-4)`
441
+ (v7.14 — dulu angka tetap 64 untuk model/picker/provider/form). Semua
442
+ permukaan popup (picker, model, provider, form, wizard, **approval**) memakai
443
+ fungsi yang SAMA — tak ada permukaan yang memakai lebar layar penuh seperti
444
+ approval sebelum v7.14 (AUD-007). Nilai dihitung sekali per mount lalu
445
+ dikirim sebagai `minWidth == maxWidth` sehingga kotak tak "bernapas" selama
446
+ popup terbuka, tetapi tiap mount menyesuaikan terminal. Margin 4 kolom
447
+ SELALU menang atas lantai 40 (terminal < 44 kolom tidak overflow, AUD-011).
448
+ Sudut kotak MELENGKUNG `╭ ╮ ╰ ╯` secara default; `MINICODE_BOX=square`
449
+ mengembalikan lancip, `MINICODE_BOX=ascii`/`MINICODE_ASCII=1` ke ASCII.
450
+ Nama/ID di depan label; seleksi murni warna; search selalu tampil.
374
451
  21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
375
452
  select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
376
453
  luar kotak. Esc dua-tahap: tekan-1 KEMBALIKAN nilai bawaan field
@@ -526,22 +603,24 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
526
603
  ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
527
604
  `plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
528
605
  PermissionMode AUTO/ASK.
529
- **Footer:** Work Mode tampil di kiri dengan label produk `Work Mode: Build`,
530
- `Work Mode: Plan`, atau `Work Mode: Discuss`; alias internal `EXECUTE` tidak
531
- ditampilkan. Permission Mode tampil di kanan dekat token konteks sebagai
532
- `Permission Mode: Auto` atau `Permission Mode: Ask`. Nilai Work Mode memakai
533
- warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu mudah
534
- dibedakan. Pada terminal sempit label dipadatkan, tetapi kedua nilai mode
535
- dipertahankan selama lebar memungkinkan.
606
+ **Footer:** Work Mode tampil di kiri (nilai `Build`/`Plan`/`Discuss`; alias
607
+ internal `EXECUTE` ditampilkan `Build`). Permission Mode tampil di kanan dekat
608
+ token konteks sebagai nilai `Auto`/`Ask`. Label produk `Work Mode:` dan
609
+ `Permission Mode:` dihapus v0.24 — nilai saja, lebih lega. Nilai Work Mode
610
+ memakai warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu
611
+ mudah dibedakan. Titik `●` kuning = bash allow-list aktif, abu = nonaktif,
612
+ `○` merah = unrestricted. Bila ada job background hidup, badge `◷ N` tampil
613
+ di samping spark.
536
614
 
537
615
  ## Grammar (ringkas)
538
616
 
539
617
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
540
618
  berbingkai di atasnya) ·
541
- status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto 🔒`
619
+ status bar `✦ 00.00.00 Discuss model cwd … context Auto ●`
542
620
  (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
543
621
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
544
- dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
622
+ `Work Mode:`/`Permission Mode:` dihapus; `●` kuning = bash allow-list aktif,
623
+ abu = tidak, `○` merah = unrestricted; badge `◷ N` bila job background hidup)
545
624
  + satu spacer sebelum footer · ledger tool
546
625
  ` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
547
626
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
@@ -659,7 +738,8 @@ panjang).
659
738
  pola mati dihapus, subset p15..p24 hadir di kedua job.
660
739
 
661
740
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
662
- anti-hantu).
741
+ anti-hantu) + I13 (App.paintRegion/clearRegion mendelegasikan region modal ke
742
+ screen; clock badge memutar `◷` saat idle lalu berhenti saat quit).
663
743
  - `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
664
744
  Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
665
745
  select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
@@ -677,8 +757,13 @@ panjang).
677
757
  `sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
678
758
  sekadar di-import tidak menulis byte ke alt-screen.
679
759
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
680
- stdout-pipe tanpa sink = deny).
681
- - `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, ikon gembok 🔒 terang/redup).
760
+ stdout-pipe tanpa sink = deny) + modal v0.24 (kotak dilukis via
761
+ `paintRegion`, `clearRegion` dipanggil saat selesai, input raw-mode di-echo
762
+ ke kotak, Esc/Ctrl+C = batal fail-closed).
763
+ - `test/background-job-badge.test.ts` — I13 (badge `◷ N` = jumlah job hidup,
764
+ fase berputar dari clock idle, `[BG:n]` fallback ASCII, nol byte saat 0) +
765
+ `onBackgroundJobFinished` emit TEPAT SEKALI per job (error+close tidak dobel).
766
+ - `test/footer-render.test.ts` — I13 (nilai mode title case tanpa label produk, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, titik `●` kuning/abu + `○` merah unrestricted, badge `◷ N`/`[BG:N]`).
682
767
  - `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
683
768
  kind `context-window` berisi `usedTokens`/`windowTokens` setelah
684
769
  `step:completed` — sumber live-occupancy footer; nilai > 0 terbukti).
@@ -126,7 +126,7 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
126
126
 
127
127
  Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard vs bar loading) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. Bar loading startup (`src/ui/runtime/loading-bar.ts`) adalah painter transient jenis kedua: single-line blok `▓░` + persen + label, digambar ulang hanya saat `update(label, percent)` dipanggil, TTY-only (non-TTY = no-op nol byte), label disanitasi. Diagnostik fase startup (identity/writer/resume/recovery/context) didefer saat REPL ke `ctx.startupNotices` dan di-flush ke transcript TUI; non-interaktif tetap mencetak langsung. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `loading-bar`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
128
128
 
129
- Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
129
+ Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Discuss model cwd … context Auto ●` — nilai mode saja, label produk `Work Mode:`/`Permission Mode:` dihapus v0.24; titik `●` kuning=allow-list aktif, abu=nonaktif, `○` merah=unrestricted, badge `◷ N` bila job background hidup) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
130
130
 
131
131
  ## Modul kunci
132
132
 
@@ -1,4 +1,4 @@
1
- # Autonomous Scheduler (eksperimental)
1
+ # Autonomous Scheduler & Open Work (eksperimental)
2
2
 
3
3
  > **Eksperimental.** Opt-in per invokasi, nonaktif secara bawaan, dan dipicu manual.
4
4
  > Tidak ada timer latar (no background timer). Tidak ada yang berjalan kecuali Anda memintanya.
@@ -135,8 +135,289 @@ kebijakannya sempit, bukan permisif.
135
135
  tertutup.
136
136
  - Eksperimental. Antarmukanya bisa berubah.
137
137
 
138
+ ## Open Work lintas sesi
139
+
140
+ ```
141
+ minicode openwork ① TEMUKAN (read-only, lintas sesi)
142
+ minicode openwork inventory ①b AUDIT (inventaris P14.0 lintas sumber)
143
+ minicode openwork context --session S --task tN
144
+ ①c SUSUN KONTEKS (P14.5, tanpa eksekusi)
145
+ minicode --session <target> \
146
+ --adopt-task <source>/<taskId> "..." ② ADOPSI (eksplisit, otoritas ganda)
147
+ /scheduler run ③ LANJUTKAN (manual, lewat gate continuity)
148
+ (minimum satu turn) ④ KERJAKAN (claim = generasi BARU)
149
+ minicode openwork --closed ⑤ TUTUP (feedback berprovenance)
150
+ minicode openwork export --out FILE ⑤b EKSPOR (json/md, atomik)
151
+ minicode openwork merge ... ⑥ DEDUP (eksplisit + evidence)
152
+ ```
153
+
154
+ ### ① Menemukan: `minicode openwork`
155
+
156
+ Portofolio read-only seluruh task non-terminal di **workspace ini** (tasks.db
157
+ memang per-workspace — sesi proyek lain memang tidak terlihat, itu batas yang
158
+ benar, bukan bug), **ditambah** kandidat intent terstruktur dari histori
159
+ (lihat "Kandidat intent" di bawah).
160
+
161
+ ```
162
+ Open Work — 1 item(s) · 1 intent · 1 stale · 0 unknown-provenance
163
+ workspace: D:\proyek · stale after 7d · TaskStore remains the sole status authority
164
+
165
+ p14ow-source/t1 · IN_PROGRESS · PARTIAL · P2 · 2d old
166
+ title: Fix login bug
167
+ flags: STALE · FROM:p14ow-source · SIMILAR×2(UNPROVEN)
168
+ blockers: TASK_BLOCKED: API key rotated
169
+ depends on: t2 (PENDING, unsatisfied)
170
+ next: resume: rebuild context from provenance, then continue via TaskStore/Scheduler
171
+ ```
172
+
173
+ Arti bidang:
174
+
175
+ | Bidang | Makna |
176
+ |---|---|
177
+ | `status` | status kanonik TaskStore — **satu-satunya otoritas** |
178
+ | state (kolom ke-4) | state P14.1 berbasis bukti: `OPEN/PARTIAL/BLOCKED/WAITING_FOR_USER/DELEGATED/FAILED_NEEDS_FOLLOWUP/UNKNOWN`; verifikasi gagal → FAILED_NEEDS_FOLLOWUP, dependensi tak tuntas → BLOCKED |
179
+ | `P0..P3` | prioritas presentasi: BLOCKED/FAILED=P0, WAITING/DELEGATED/UNKNOWN=P1, PARTIAL=P2, OPEN=P3; item STALE dinaikkan satu tingkat — umur sinyal, bukan bukti |
180
+ | `blockers:` | blocker eksplisit (TASK_BLOCKED / DEPENDENCY / VERIFICATION); kosong = tidak ada yang diklaim |
181
+ | `depends on:` | dependensi kanonik direkonsiliasi ke status saat baca; hanya COMPLETED yang *satisfied* |
182
+ | `next:` | tindak lanjut eksplisit — selalu lewat jalur otoritas yang ada; openwork TIDAK PERNAH mengeksekusi |
183
+
184
+ Arti penanda:
185
+
186
+ | Penanda | Makna | Tindak lanjut |
187
+ |---|---|---|
188
+ | `STALE` | baris tak bergerak ≥ ambang (default 7 hari, `--stale-days <n>`) | prioritas, bukan keputusan otoritas |
189
+ | `PROVENANCE-UNKNOWN` | tidak ada baris sesi di sessions.db — asal tak bisa ditelusuri | periksa manual; jangan dianggap rusak |
190
+ | `FROM:<sesi>` | task ini DIPINDAHKAN dari sesi lain (ledger `task_transfers`) | provenance asal eksplisit |
191
+ | `SIMILAR×N(UNPROVEN)` | N task berbagi judul ternormalisasi | **bukan bukti duplikat** — lihat ⑥ |
192
+ | `DUP-GROUP×N(UNPROVEN)` | grup duplikat **lintas sesi** (task + intent) beranggota N | lihat seksi "Grup duplikat lintas sesi" |
193
+
194
+ Filter: `--session <id>`, `--status <S>`, `--state <S>`, `--priority <P0..P3>`,
195
+ `--min-age-days <n>`, `--blocked`, `--depends-on <taskId>`, `--closed`,
196
+ `--json` (satu objek JSON mesin di stdout). Exit: `0` sukses (termasuk daftar
197
+ kosong), `1` gagal runtime/lookup, `2` salah pakai (nilai enum tak dikenal
198
+ termasuk).
199
+
200
+ **Batas kejujuran:** `openwork` tidak pernah menulis apa pun — tidak
201
+ mengakuisisi lease, tidak membuat sessions.db, tidak menulis backup manifest
202
+ korup, tidak memicu scheduler. Ia indeks, bukan otoritas. (Dijaga guard
203
+ arsitektur + tes nol-mutasi, kini termasuk jalur inventaris.)
204
+
205
+ ### Kandidat intent: histori terstruktur, TANPA menebak prosa
206
+
207
+ Portofolio juga menampilkan **kandidat intent open** dari histori yang
208
+ terstruktur dan durable:
209
+
210
+ | Sumber | Kapan jadi kandidat | State |
211
+ |---|---|---|
212
+ | `plan.updated` | langkah plan `pending`/`active`/`blocked` **tanpa** task kanonik (atau baris task-nya hilang) | OPEN / PARTIAL / BLOCKED |
213
+ | `approval.requested` | belum ada `approval.settled` | WAITING_FOR_USER |
214
+ | sesi anak sub-agent | belum ada hasil terminal | DELEGATED |
215
+ | sesi anak + `turn.failed` | delegasi gagal | FAILED_NEEDS_FOLLOWUP |
216
+ | run `INTERRUPTED` | eksekusi terputus (restart/kill) | FAILED_NEEDS_FOLLOWUP |
217
+
218
+ Yang SENGAJA tidak dilakukan: memindai isi pesan bebas pengguna. Janji dari
219
+ prosa ("nanti kita perbaiki login") TIDAK PERNAH menjadi tugas — roadmap P14
220
+ melarang menganggap brainstorming sebagai task, dan menentukan kapan intent
221
+ prosa jadi komitmen adalah keputusan produk yang belum diputuskan pemilik.
222
+
223
+ Aturan kejujuran ekstraksi (dijaga tes):
224
+
225
+ 1. Langkah plan yang menunjuk task kanonik yang masih OPEN **menempel sebagai
226
+ bukti** di entri task (`plan evidence`), bukan item duplikat.
227
+ 2. Langkah plan yang mengaku `active` atas task yang SUDAH terminal tidak
228
+ dihidupkan kembali — masuk closure dengan alasan "canonical task
229
+ <status> supersedes plan claim", konflik diungkap, bukan disembunyikan.
230
+ 3. Approval yang di-**allow** bukan bukti pekerjaan selesai — tidak
231
+ menghasilkan kandidat apa pun (hanya deny yang menghasilkan DECLINED).
232
+ 4. Run `RUNNING` bukan open loop — runtime hidup adalah kondisi normal.
233
+ 5. Cakupan pencarian dibatasi binding `cwd` baris sesi; **sesi anak mewarisi
234
+ cakupan leluhur termulaiannya** (hasil sub-agent tetap terlihat); sesi
235
+ tanpa binding dilabel UNBOUND dan dikeluarkan — tidak ada yang ditebak.
236
+ 6. `plan.updated` adalah **snapshot**, bukan delta: adaptor menerbitkannya setiap
237
+ `todo_write` sukses dengan SELURUH daftar langkah. Hanya snapshot TERAKHIR
238
+ per **sesi** yang dibaca (bukan per `planId` — `planId` memuat nomor turn,
239
+ sedangkan daftar todo milik sesi). Akibatnya: versi pending/active lama tidak
240
+ muncul sebagai open loop kedua, langkah yang dihapus dari daftar tidak
241
+ dihidupkan, dan langkah yang masih terbuka tidak berganda di setiap turn.
242
+
243
+ ### Grup duplikat lintas sesi (P14.3 penuh)
244
+
245
+ Kandidat dengan judul ternormalisasi sama **lintas sesi** (termasuk task vs
246
+ langkah plan) dikelompokkan dan diungkapkan:
247
+
248
+ ```
249
+ Similar groups — 1 (UNPROVEN, never auto-merged)
250
+ "fix login bug" ×2 across 2 session(s) · DIVERGENT states
251
+ sessions: p14fs-a · p14fs-b
252
+ ```
253
+
254
+ Grup dengan state yang saling bertentangan ditandai `DIVERGENT` (jumlahnya
255
+ juga di header + `counts.conflicts`). Grup **tidak pernah** menyatukkan apa
256
+ pun: perpindahan otoritas tetap wajib adopsi eksplisit (②), merge tetap
257
+ satu-sesi (⑥). Tugas berulang yang sengaja independen boleh berbagi grup —
258
+ itu penanda untuk diperiksa, bukan vonis.
259
+
260
+ ### ①b Inventaris: `minicode openwork inventory [--json]`
261
+
262
+ Inventaris P14.0 lintas sumber, read-only: jumlah sesi (in-scope / foreign /
263
+ unbound / anak), task (total/open/terminal), event presentasi per tipe, run,
264
+ manifest checkpoint (termasuk yang **corrupt** — dilabel, tidak dibackup oleh
265
+ proyeksi), langkah plan, approval, dan hasil sub-agent. Sesi yang dikeluarkan
266
+ dicantumkan **dengan alasannya**. Event yang gagal didekode dilaporkan sebagai
267
+ "unreadable", tidak disembunyikan.
268
+
269
+ ### ①c Konteks: `minicode openwork context --session <id> --task <taskId>`
270
+
271
+ Context pack P14.5 untuk satu task: field kanonik (status/revisi/verification/
272
+ dependsOn/evidence), state + prioritas + blocker + next action, bukti langkah
273
+ plan, ketersediaan checkpoint (termasuk corrupt), provenance transfer/merge,
274
+ freshness, dan **checklist resume**. Pack ini murni baca — checklist menunjuk
275
+ jalur yang MEMAKSAK otoritas saat resume (ceiling P12, gate continuity P13.3,
276
+ claim generation TaskStore, budget/cancellation P12/P13); openwork sendiri
277
+ tidak memeriksa apalagi mengeksekusi. Exit `1` bila task tak ditemukan,
278
+ `2` bila id cacat.
279
+
280
+ ### ② Mengadopsi: `--adopt-task <source>/<taskId>`
281
+
282
+ Satu task per invokasi, HANYA saat startup sesi tujuan, sebelum turn pertama:
283
+
284
+ ```
285
+ minicode --session target --adopt-task p14ow-source/t1 "lanjutkan pekerjaan ini"
286
+ ```
287
+
288
+ Yang terjadi (satu transaksi TaskStore, dicek ulang di dalam transaksi):
289
+ inkarnasi sumber+tujuan, revisi, **kedua lease** (token sumber dan tujuan),
290
+ status non-terminal, konsistensi lineage, tabrakan id target, dan provenance
291
+ relasi. Penulis sesi sumber yang **hidup** = `REFUSED_SOURCE_BUSY` (tidak ada
292
+ takeover paksa). Lease sumber kedaluwarsa = takeover + **fence epoch** —
293
+ proses lama tidak bisa lagi renew/release/menulis/menjadwalkan sesi sumber.
294
+
295
+ Yang TIDAK terjadi: tidak menyalin task, tidak membuat generasi baru, tidak
296
+ menandai selesai, tidak menyentuh jurnal runtime/child run/approval, dan
297
+ **tidak memicu scheduler**. Task in-flight hasil adopsi tetap `IN_PROGRESS`
298
+ dengan lineage asli — apakah boleh dilanjutkan adalah keputusan gate (③),
299
+ bukan adopsi.
300
+
301
+ Rantai relasi diadopsi **berurutan** (parent/dependency dulu, lalu anak);
302
+ penolakan menamai id yang belum diadopsi. Id task tidak pernah direnumber.
303
+
304
+ ### ③ Melanjutkan: `/scheduler run` (manual, tersupervisi)
305
+
306
+ Adopsi tidak menyalakan scheduler. Lanjutan tetap lewat trigger manual yang
307
+ sudah ada (`/scheduler run` di sesi TUJUAN; butuh `--enable-scheduler` saat
308
+ memulai sesi CLI, sedangkan sesi daemon hosted mendapatkannya via
309
+ `--runtime owned`). Reconcilasi menilai task in-flight hasil
310
+ adopsi lewat **continuity gate P13.3** — kontraknya tidak berubah:
311
+
312
+ - `SAFE_TO_RETRY` (bukti resume + admission + **seluruh** scope tool otonom
313
+ read-only) → revert ke PENDING → **claim generasi BARU** → dispatch serial.
314
+ - Selain itu → `HOLD` / `REQUIRES_VERIFIER`, baris tidak disentuh, nol
315
+ dispatch. Tanpa gate = HOLD (fail-closed).
316
+
317
+ **Tidak pernah ada replay instruksi tool jurnal lama** — work item hanya
318
+ membawa `(taskId, title, instruction, sessionId)`; eksekusi baru lahir dari
319
+ claim baru. Permission ceiling P12, budget, cancellation, dan stop criteria
320
+ P13 tetap berlaku persis seperti sesi biasa.
321
+
322
+ ### ④ Menutup: lifecycle biasa
323
+
324
+ Selesaian lewat jalur kanonik yang sudah ada (verifier / `todo_write` /
325
+ operator) — P14 tidak punya jalur penutupan sendiri dan tidak pernah
326
+ menulis `COMPLETED` atas nama operator.
327
+
328
+ ### ⑤ Feedback penutupan: `minicode openwork --closed`
329
+
330
+ Closure feedback adalah **pembacaan ulang status kanonik + ledger**, bukan
331
+ kesimpulan: task yang sudah terminal dan punya provenance P14 (transfer
332
+ atau merge) muncul dengan `status`, `closed`, `FROM <sesi>`,
333
+ `duplicate-of <task>`, dan evidence operator. Duplikat yang dibuka kembali
334
+ operator otomatis muncul lagi di seksi open — status saat itulah kebenaran.
335
+
336
+ Sejak pengiriman full-scope, closure juga mencakup **artefak intent terminal**
337
+ (`kind INTENT`) dengan **label klaim** yang wajib dibaca:
338
+
339
+ | `claim` | Arti |
340
+ |---|---|
341
+ | `verified` | task kanonik terminal dengan `verification.verdict = passed` |
342
+ | `unverified` | klaim penyelesaian oleh artefak (mis. plan step `completed`) **tanpa** verifikasi — ditampilkan apa adanya, BUKAN disembunyikan, BUKAN dianggap terbukti |
343
+ | `not-applicable` | DECLINED/CANCELLED — tidak ada klaim penyelesaian untuk diverifikasi |
344
+
345
+ Termasuk: approval yang ditolak pengguna → `DECLINED` (terminal, tidak pernah
346
+ hidup lagi sebagai open loop), dan langkah plan yang mengaku `active` atas task
347
+ terminal → closure dengan alasan "canonical task `<status>` supersedes plan
348
+ claim" — konflik klaim diungkap, tidak ditelan.
349
+
350
+ ### ⑤b Ekspor: `minicode openwork export --out <path> [--format json|md] [--force]`
351
+
352
+ - `json` (default) — objek portofolio lengkap (selalu menyertakan inventaris
353
+ P14.0), indentasi 2 spasi.
354
+ - `md` — laporan manusia tersanitasi (judul/evidence bebas sekuens ANSI).
355
+ - Ditulis **atomik** (`atomicWriteText`); **menolak menimpa** berkas yang ada
356
+ kecuali `--force`; kegagalan tulis = exit `1` tanpa berkas sampah `.tmp.*`.
357
+
358
+ ### ⑥ Dedup eksplisit: `openwork merge`
359
+
360
+ ```
361
+ minicode openwork merge --session target --keep t1 --drop t2 \
362
+ --evidence "satu unit kerja yang sama: sama-sama memperbaiki login bug"
363
+ ```
364
+
365
+ Aturan (dijaga tes + guard):
366
+
367
+ 1. **Evidence WAJIB** dan direkam utuh di ledger append-only `task_merges`.
368
+ Kemiripan judul TIDAK PERNAH menjadi bukti; `SIMILAR×N(UNPROVEN)` hanyalah
369
+ penanda. Tidak ada merge otomatis dari proyeksi.
370
+ 2. Duplikat ditutup **`CANCELLED`, bukan `COMPLETED`** — menyatakan "dikerjakan
371
+ di task lain" tidak boleh meng-inferr penyelesaian.
372
+ 3. Penulisan status lewat `patchTask` (lifecycle biasa: revisi maju, ownership
373
+ in-flight dilepas) + INSERT ledger dalam **SATU transaksi** — gagal ledger =
374
+ status ikut rollback.
375
+ 4. Duplikat terminal ditolak (pekerjaan tertutup tidak dibuka untuk ditutup
376
+ lagi). Survivor terminal BOLEH (kasus klasik: pending ternyata sudah
377
+ dikerjakan task yang selesai — duplikat tetap CANCELLED).
378
+ 5. **Antar-sesi ditolak**: merge hanya satu namespace. Duplikat lintas sesi
379
+ harus diadopsi dulu (②), lalu merge di sesi tujuan.
380
+ 6. Pembalikan = penulisan lifecycle biasa (patch status kembali). Ledger
381
+ append-only tetap mencatat deklarasi — audit sejarah, status = kebenaran.
382
+
383
+ ### Peta bukti
384
+
385
+ | Klaim | Bukti |
386
+ |---|---|
387
+ | Proyeksi read-only (nol mutasi) | `test/p14-open-work.test.ts` (proyeksi nol-mutasi) |
388
+ | Nol mutasi jalur PENUH (histori + inventaris ikut diuji; tanpa backup manifest korup) | `test/p14-full-scope.test.ts` (zero-mutasi proyeksi penuh) |
389
+ | UNKNOWN/stale dilabel jujur | `test/p14-open-work.test.ts` (provenance UNKNOWN tanpa membuat sessions.db; STALE ambang disuntik) |
390
+ | Kemiripan bukan identitas | idem (SIMILAR UNPROVEN, ambiguous tetap terpisah) |
391
+ | Grup duplikat LINTAS SESI + konflik divergent, tanpa merge otomatis | `test/p14-full-scope.test.ts` (P14.3 grup lintas sesi) |
392
+ | Kontrak P14.1: state/prioritas/next action murni + fail-closed | idem (P14.1 kontrak murni) |
393
+ | Ekstraksi intent: approval allow ≠ COMPLETED; pesan bebas tak dipindai; cakupan lineage | idem (P14.2 extractIntentCandidates) |
394
+ | Klaim plan atas task terminal: tak dihidupkan, konflik diungkap, label claim verified/unverified | idem (P14.2 proyeksi histori) |
395
+ | Inventaris P14.0 lintas sumber + sesi dikeluarkan dengan alasan | idem (P14.0 inventaris) |
396
+ | Matriks forensik: restart/terputus/pembatalan/stale | idem (P14.6 matriks forensik) |
397
+ | Portofolio: blocker/dependensi/verifikasi/next action | idem (P14.4 bidang portofolio) |
398
+ | CLI: filter baru, inventory, context, export atomik + sanitasi | idem (CLI full-scope; exit 0/1/2 sesuai I28) |
399
+ | Merge aman/auditable/atomic | `test/p14-open-work.test.ts` (DECLARED/refusal/terminal/stale/atomic-rollback/pembalikan) |
400
+ | Alur ①→⑤ utuh, generasi baru, tanpa replay | idem (P14.5 alur operator) |
401
+ | Adopsi: otoritas ganda, fence, ledger transfer | `test/p14-cross-session-adoption.test.ts` (14 skenario) |
402
+ | Guard "bukan TaskStore/scheduler kedua" + proyeksi murni | `test/p2-architecture-guards.test.ts` |
403
+ | Kontrak penulis CLI (OAP-008) | `test/writer-inventory.test.ts` (deklarasi per writer) |
404
+ | Snapshot `plan.updated` dikolaps per sesi (tanpa duplikasi riwayat) | `test/p14-full-scope.test.ts` (5 tes snapshot plan) |
405
+
406
+ ### Batas scope yang TIDAK diklaim
407
+
408
+ Dokumen ini sengaja tidak menjanjikan hal-hal berikut; semuanya eksklusi
409
+ scope P14 yang disetujui pemilik 2026-10-26, bukan pekerjaan tertunda:
410
+
411
+ | Tidak ada | Alasan |
412
+ |---|---|
413
+ | Ekstraksi intent dari prosa bebas | Dilarang eksplisit oleh roadmap ("jangan anggap setiap pesan brainstorming sebagai tugas") |
414
+ | Readout TUI `/openwork` | Teks milestone hanya "tampilkan/ekspor"; permukaan TUI baru butuh kontrak terminal sendiri |
415
+ | Merge dengan lease/admission | Di luar teks milestone; merge tetap satu transaksi + ledger audit |
416
+ | Merge lintas sesi tanpa adopsi eksplisit | Model otoritas roadmap: portfolio = projection, perubahan task lewat jalur authority |
417
+ | Klaim release-ready | Closure P14 hanya untuk kontrak bukti-terstruktur; limitasi P13 tetap berlaku dan tree masih uncommitted |
418
+
138
419
  ## Terkait
139
420
 
140
421
  - [CLI](cli.md) — referensi lengkap flag.
141
422
  - [Arsitektur](architecture.md) — di mana scheduler berada.
142
- - [Open Work](P14_OPEN_WORK.md) — pekerjaan lintas sesi yang diteruskan scheduler.
423
+ - [Open Work](autonomous-scheduler.md) — pekerjaan lintas sesi yang diteruskan scheduler.
@@ -6,7 +6,7 @@ Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
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 — **kecuali mode `unrestricted`** (lihat baris terakhir tabel).
9
+ Hard security (path jail luar workspace, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya — **kecuali mode `unrestricted`**, yang membuka jail path luar workspace + bash-guard + allowlist, tetapi file sensitif (`.env`, `.ssh`) dan state milik minicode (`.minicode/`) tetap ditolak (lihat baris terakhir tabel).
10
10
 
11
11
  ## Kalau tujuan Anda X → gunakan Y
12
12
 
@@ -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 🔓 terang (bukan redup) |
21
+ | Full akses tanpa pembatas (VM/VPN tepercaya) | `/unrestric` (perintah TUI tersembunyi, per-sesi) | Melepas jail path luar workspace + bash-guard + allowlist/sandbox; kredensial git sempit (`GH_TOKEN`/`GITHUB_TOKEN`/`SSH_AUTH_SOCK`) diteruskan hanya di mode ini; file sensitif dan state minicode tetap ditolak; footer menampilkan `○` merah |
22
22
 
23
23
  ## Rule of thumb
24
24
 
@@ -27,7 +27,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
27
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.
28
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.
29
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.
30
+ 6. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — model bisa menyentuh file apa pun di host (kecuali file sensitif/state minicode), menjalankan shell tanpa allow-list, dan `git_push` ke remote. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
31
31
 
32
32
  ## Tradeoff yang jujur
33
33
 
@@ -37,7 +37,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
37
37
 
38
38
  ## Lanjut
39
39
 
40
- - [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
40
+ - [Keamanan](security.md) — apa yang ditegakkan tiap mode.
41
41
  - [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
42
42
  - [Otomasi & CI](exec.md) — batasan headless.
43
43
  - [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
package/docs/concepts.md CHANGED
@@ -28,7 +28,7 @@ ditulis sendiri) dan membagi dua jalur secara tegas:
28
28
  buffer utama kembali persis (transkrip tidak di-dump ke scrollback).
29
29
  - Warna hanya saat TTY; `NO_COLOR` selalu menang; output program tetap bersih dari cursor-control saat di-pipe.
30
30
 
31
- Detail lengkap + kontrak FROZEN-nya di [Kontrak Terminal](terminal.md).
31
+ Detail lengkap + kontrak FROZEN-nya di [Kontrak Terminal](TERMINAL_CONTRACT.md).
32
32
 
33
33
  ## Kejujuran sebagai fitur
34
34
 
@@ -45,9 +45,45 @@ Runtime tanpa dependency pihak ketiga; satu-satunya kebutuhan keras adalah **Bun
45
45
 
46
46
  ## Bahasa
47
47
 
48
- Dokumentasi dan komentar kode berbahasa **Indonesia** dengan istilah teknis tetap English (`provider`, `checkpoint`, `sandbox`, `jail`). Lihat [Glosarium](glossary.md) untuk daftar istilah.
48
+ Dokumentasi dan komentar kode berbahasa **Indonesia** dengan istilah teknis tetap English (`provider`, `checkpoint`, `sandbox`, `jail`). Tabel di bawah mengunci makna istilah yang paling sering dipakai.
49
+
50
+ ## Glosarium
51
+
52
+ Istilah MiniCode yang punya makna spesifik. Dokumentasi berbahasa Indonesia dengan
53
+ istilah teknis English — tabel ini mengunci maknanya.
54
+
55
+ | Istilah | Makna |
56
+ |---|---|
57
+ | **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP` di-vendor ke `vendor/minicore`; inti beku, zero-dep, di-resolve via `#minicore` |
58
+ | **Minicode** | Layer agencode di atas MiniCore: tools, agents, policy, providers, memory, sessions, CLI |
59
+ | **Tool** | Kemampuan yang dipilih model dalam loop ReAct; tool MCP dapat ditambahkan dinamis sebagai `serverId.toolName` |
60
+ | **Tool scope** | `full` atau subset read-only `explore` — flag `--tool-scope` |
61
+ | **WorkMode** | Cara agent bekerja: `DISCUSS`, `PLAN`, atau `BUILD` (alias produk untuk identitas internal `EXECUTE`) |
62
+ | **PermissionMode** | Pilihan pengawasan: `AUTO` menjalankan capability yang diotorisasi; `ASK` meminta persetujuan untuk aksi yang digate |
63
+ | **Tool Access Policy** | Batas capability yang tersedia, seperti read-only, allowlist, atau profil akses warisan `--allow-all` |
64
+ | **Gate** | Tool wajib persetujuan manusia saat TTY; non-TTY selalu tolak (mis. `git_commit`, MCP, `delegate_task`) |
65
+ | **Path jail** | Pembatasan akses file ke workspace (realpath + symlink; `O_NOFOLLOW` pada POSIX dan pencocokan identitas handle `dev+ino` pada semua platform); aktif bahkan `--allow-all` |
66
+ | **Bash-guard** | Normalisasi + blokir pola bash berbahaya sebelum eksekusi (quote-split, indirection, wrapper) |
67
+ | **Sandbox OS** | bubblewrap (Linux) / seatbelt (macOS) — otomatis bila tersedia |
68
+ | **Sandbox Docker** | Container ephemeral `--network none`, 512m, 1 CPU, `node:22-alpine` |
69
+ | **Checkpoint** | Snapshot per turn via shadow-git: SHA tree di `refs/minicode/…` (O(delta), HEAD/index tak tersentuh) |
70
+ | **Recovery journal** | `journal-<sesi>.jsonl`: `pending` → `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn yang sudah durable |
71
+ | **Session** | Riwayat tersimpan di `.minicode/sessions.db` (SQLite WAL); kompaksi dapat mengganti bagian lama dengan ringkasan + tail |
72
+ | **Memory dua lapis** | `MEMORY.md` hierarki (selalu ke system prompt) + vector RAG hybrid (injeksi bila skor ≥ ambang) |
73
+ | **RAG hybrid** | Pencarian memory cosine 0.7 + keyword 0.3, ranking MMR (λ 0.7), dedup >0.92 |
74
+ | **Repo-map** | Simbol per file (regex 9 bahasa, fallback LSP) disuntik ke system prompt |
75
+ | **Skill** | Prompt terpaket `.minicode/skills/*.md` dengan frontmatter `name`/`description` |
76
+ | **Hook** | Skrip `pre/post-run` dari `~/.minicode/hooks` + `.minicode/hooks`; mati default, `MINICODE_HOOKS=1` |
77
+ | **Env scrub** | `sanitizeSpawnEnv` menghapus kata-kunci kredensial dari env subprocess |
78
+ | **Secret scrubber** | Redaksi `sk-`/`ghp_`/`AKIA`/PEM/JWT/Bearer sebelum teks ke LLM |
79
+ | **Ledger** | Baris ` › name target` / ` › name: …` di stderr — jejak aksi agent |
80
+ | **Scrollback** | Riwayat layar terminal; jalur non-interaktif minicode append-only di sana (interaktif pakai alternate screen) |
81
+ | **Transient** | UI muncul-sekali yang menghapus dirinya (spinner, garis status turn) — vs transkrip yang menetap |
82
+ | **Composition root** | `cli/index.ts` + `cli/setup.ts`: satu tempat wiring DI (provider, RAG, session, tools) |
83
+ | **Seam aditif** | Satu-satunya patch yang dibolehkan ke kernel beku: `compactAsync`, `initialMessages`, `cwd` |
84
+ | **Self-contained** | Tanpa clone repo lain — kernel di-vendor, runtime zero-dep, butuh Bun ≥ 1.1.13 |
49
85
 
50
86
  ## Lanjut
51
87
 
52
88
  - [Arsitektur](architecture.md) — tiga lapisan, boundary, alur satu prompt.
53
- - [Quickstart](quickstart.md) — dari nol ke prompt pertama yang ter-verify.
89
+ - [Instalasi & Quickstart](getting-started.md) — dari nol ke prompt pertama yang ter-verify.