minicode-ai 0.14.0 → 0.14.2

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 (88) hide show
  1. package/README.md +1 -1
  2. package/cli/args.ts +16 -3
  3. package/cli/auto-update.ts +32 -2
  4. package/cli/commands/exec.ts +9 -0
  5. package/cli/index.ts +31 -13
  6. package/cli/setup.ts +31 -19
  7. package/cli/tui.ts +63 -40
  8. package/docs/OUTPUT_PROTOCOL_SPEC.md +6 -0
  9. package/docs/OUTPUT_RENDERING_SPEC.md +28 -4
  10. package/docs/README.md +2 -2
  11. package/docs/TERMINAL_CONTRACT.md +52 -26
  12. package/docs/agents.md +2 -2
  13. package/docs/choosing-mode.md +20 -13
  14. package/docs/cli.md +11 -11
  15. package/docs/environment.md +3 -3
  16. package/docs/getting-started.md +14 -12
  17. package/docs/glossary.md +1 -1
  18. package/docs/mcp-lsp.md +1 -1
  19. package/docs/policy-sandbox.md +7 -1
  20. package/docs/security-model.md +2 -2
  21. package/docs/security.md +7 -1
  22. package/docs/tools.md +4 -4
  23. package/docs/verify-benchmark.md +16 -0
  24. package/package.json +1 -3
  25. package/src/app/mentions.ts +4 -3
  26. package/src/app/session.ts +19 -9
  27. package/src/app/tool-layer.ts +10 -3
  28. package/src/constants.ts +17 -0
  29. package/src/lib/git-hardening.ts +27 -22
  30. package/src/lib/safe-open.ts +73 -19
  31. package/src/lib/trusted-exec.ts +7 -4
  32. package/src/mcp/client.ts +34 -9
  33. package/src/mcp/transport.ts +96 -42
  34. package/src/memory/files.ts +15 -4
  35. package/src/memory/vector.ts +5 -1
  36. package/src/policy/context.ts +21 -13
  37. package/src/policy/permission.ts +75 -16
  38. package/src/policy/tool-contract.ts +21 -10
  39. package/src/policy/update-check.ts +83 -6
  40. package/src/policy/usage.ts +17 -7
  41. package/src/policy/work-mode.ts +51 -17
  42. package/src/presentation/adapter.ts +64 -2
  43. package/src/presentation/events.ts +6 -0
  44. package/src/presentation/model.ts +1 -0
  45. package/src/presentation/projection.ts +2 -0
  46. package/src/presentation/reducer.ts +1 -0
  47. package/src/providers/anthropic.ts +52 -19
  48. package/src/providers/guards.ts +98 -13
  49. package/src/providers/responses.ts +61 -23
  50. package/src/providers/sse-bounds.ts +170 -0
  51. package/src/repo/repomap.ts +10 -11
  52. package/src/runtime/execution-backend.ts +7 -8
  53. package/src/sandbox/docker.ts +113 -9
  54. package/src/session/checkpoint.ts +9 -2
  55. package/src/session/persistence.ts +5 -2
  56. package/src/session/verification.ts +55 -16
  57. package/src/skills/loader.ts +16 -3
  58. package/src/tools/bash.ts +6 -3
  59. package/src/tools/code_run.ts +6 -5
  60. package/src/tools/context.ts +8 -0
  61. package/src/tools/delete_file.ts +2 -1
  62. package/src/tools/edit.ts +2 -1
  63. package/src/tools/git.ts +128 -54
  64. package/src/tools/glob.ts +2 -1
  65. package/src/tools/grep.ts +31 -6
  66. package/src/tools/lsp.ts +5 -4
  67. package/src/tools/mcp_call.ts +3 -1
  68. package/src/tools/memory.ts +175 -180
  69. package/src/tools/move_file.ts +2 -1
  70. package/src/tools/patch.ts +2 -1
  71. package/src/tools/read_file.ts +94 -1
  72. package/src/tools/read_image.ts +2 -1
  73. package/src/tools/task.ts +2 -1
  74. package/src/tools/todo.ts +4 -5
  75. package/src/tools/web_fetch.ts +28 -12
  76. package/src/tools/web_search.ts +28 -9
  77. package/src/tools/write_file.ts +2 -1
  78. package/src/ui/assistant/simple.ts +72 -3
  79. package/src/ui/footer.ts +17 -12
  80. package/src/ui/i18n/en.ts +6 -3
  81. package/src/ui/i18n/id.ts +6 -3
  82. package/src/ui/render/width.ts +107 -79
  83. package/src/ui/runtime/screen.ts +49 -37
  84. package/src/ui/tui/app.ts +261 -209
  85. package/src/ui/tui/transcript.ts +39 -0
  86. package/CHANGELOG.md +0 -1167
  87. package/docs/PLAN_UIUX_V6.md +0 -209
  88. package/docs/changelog.md +0 -3
@@ -1,4 +1,8 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.4, 2026-10-20)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.5, 2026-11-06)
2
+
3
+ Perubahan v7.5: kepemilikan frame stdout interaktif diperjelas; cleanup `TuiApp.run()`
4
+ berpasangan melalui `finally`; gap proteksi teardown, startup, spacer, layar kecil,
5
+ dan writer ownership ditutup dengan test app/subprocess/PTY.
2
6
 
3
7
  Perubahan v7.4 (P12 S2.2 WorkMode): invarian baru I35 — WorkMode (lapis
4
8
  intent `DISCUSS`/`PLAN`/`EXECUTE`) sebagai dimensi TERPISAH dari permission
@@ -61,7 +65,7 @@ proteksi").
61
65
 
62
66
  | Stream | Isi | Catatan |
63
67
  |---|---|---|
64
- | stdout | Output PROGRAM yang bermakna: teks model, receipt perubahan (`› write_file …`), daftar/artefak perintah | Harus bersih dari cursor-control pada non-TTY |
68
+ | stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
65
69
  | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
66
70
  | keduanya | Warna hanya bila stream TTY (`stdout.isTTY`); `NO_COLOR` menang; TERM/COLORTERM env TIDAK menyalakan warna pada pipe/redirect | Lihat `src/ui/render/theme.ts` `colorLevel()` |
67
71
 
@@ -82,9 +86,11 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
82
86
 
83
87
  ## Ownership
84
88
 
85
- - `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit —
86
- selalu berpasangan, termasuk exception/SIGINT via handler `process.on("exit")`
87
- sinkron best-effort). Turn berjalan = indikator spark pada status bar.
89
+ - `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit).
90
+ `TuiApp.run()` melepas listener/timer/subscription, memulihkan raw mode, dan
91
+ menutup layar lewat `finally` idempoten pada jalur sukses maupun exception.
92
+ Hook `process.on("exit")` hanya jaring best-effort terakhir, bukan pengganti
93
+ cleanup lifecycle. Turn berjalan = indikator spark pada status bar.
88
94
  - **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
89
95
  `process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
90
96
  tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
@@ -227,6 +233,14 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
227
233
  tetap pada ledger tool, status tool final memakai glyph + kata
228
234
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
229
235
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
236
+ **Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
237
+ `attemptId`. Bila attempt gagal setelah mengirim konten, TUI membuang
238
+ ekor attempt yang belum di-commit dan menambah diagnostic invalidasi.
239
+ Sink linear/pipe bersifat append-only: byte yang sudah ditulis tetap ada,
240
+ sehingga sink wajib menulis marker invalidasi sebelum output attempt
241
+ berikutnya. Konten attempt gagal dikeluarkan dari `/copy`, reasoning
242
+ durable, dan jawaban akhir; usage provider tetap dihitung karena request
243
+ tersebut sudah terjadi.
230
244
  **Grup anak (F-AGENT-1):** tool anak yang punya identitas run
231
245
  (`childSessionId`/`runId` — dari `ChildSessionLink`) tampil sebagai baris
232
246
  run sendiri, diindented `↳ <marker> <tool> <target> <status>` dengan
@@ -445,7 +459,7 @@ panjang).
445
459
  > **benar-benar di-assert** oleh test yang disebut. Kehadiran nama file test
446
460
  > bukan bukti klaim. Baris yang hanya "nominal" (test ada, tapi assertion-nya
447
461
  > tak menyentuh perilaku yang diklaim) dipindah ke bagian
448
- > [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup) di bawah — jangan
462
+ > [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
449
463
  > dipoles dengan mengganti kata-kata.
450
464
 
451
465
  - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (boot/exit pairing, transcript
@@ -531,15 +545,19 @@ panjang).
531
545
  resume > default EXECUTE; nilai invalid → EXECUTE + peringatan; `--verify`
532
546
  ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
533
547
  `workMode` parity).
534
- - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
535
- editing/busy, dots clock, timer, cursor, resize, popup). *Klausul "satu baris
536
- kosong memisahkan composer dari footer" TIDAK punya assertion — lihat
537
- [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup).*
548
+ - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I14/I17 (composer
549
+ editing/busy, dots clock, timer, cursor, resize, popup; teardown saat initial,
550
+ frame, event/timer, dan resize repaint gagal; abort/scroll saat layar menciut;
551
+ spacer composer-footer).
538
552
  - `test/markdown-table.test.ts` — I8/I11 (pipe-table parser, streaming
539
553
  parity, ANSI/CJK width, TTY/non-TTY, TUI resize, machine-output policy).
540
554
  - `test/terminal-contract.test.ts` — I2/I3/I7/I8/I9 (split stdout/stderr,
541
555
  kepemilikan layar tunggal, ledger satu baris per tool, streaming tanpa
542
556
  duplikasi, foreign writer boleh mentah).
557
+ - `test/provider-retry-output.test.ts`, `test/tui-transcript.test.ts`, dan
558
+ `test/presentation-events.test.ts` — invalidasi attempt provider gagal;
559
+ TUI/transkrip/history/`/copy` tidak menggabungkan teks gagal dengan jawaban
560
+ final, sementara sink linear memberi marker dan usage tetap tercatat.
543
561
  - `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
544
562
  picker/askLine, nesting, delayMs).
545
563
  - `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
@@ -563,7 +581,12 @@ panjang).
563
581
  - `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
564
582
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
565
583
  - `test/cli-commands.test.ts` — /status cetak, /sessions popup.
566
- - `test/screen.test.ts` — I16 (pairing + paintRegion).
584
+ - `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
585
+ mencoba memulihkan alt-screen dan reset region).
586
+ - `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
587
+ yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
588
+ - `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
589
+ diagnostik stderr, stdout kosong, exit 1, provider tidak dipanggil).
567
590
  - `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box).
568
591
  - `test/tui-overlay.test.ts` — I11/I16 (popup region + gate layar).
569
592
  - `test/ui-boundary.test.ts` — I1/I3 (src/ui tak impor keluar).
@@ -579,8 +602,9 @@ panjang).
579
602
  wizard, form error).
580
603
  - `test/sanitize.test.ts` — I2 (C1/bidi/tag dibuang, ZWJ dipertahankan;
581
604
  NO_COLOR menang di cleanUntrusted).
582
- - `test/width.test.ts` — I2/I7 (tab 8 kolom; truncate/chunk hanya-SGR +
583
- auto-reset; chunk(0) kosong).
605
+ - `test/width.test.ts` — I2/I7 + UI-RENDER-01 (VS16, skin tone, ZWJ, regional
606
+ indicator, keycap, combining mark; truncate/chunk tidak memecah grapheme;
607
+ tab 8 kolom; hanya-SGR + auto-reset; chunk(0) kosong).
584
608
  - `test/exit-codes.test.ts` — I28 (0/1/2 di semua handler; lookup tetap 1;
585
609
  hermetic subprocess).
586
610
  - `test/exec-json-envelope.test.ts` — I28 (summary ok:false di stdout saat
@@ -608,12 +632,13 @@ panjang).
608
632
  ESC[5;2~; hint abort pertama), I13 (MINICODE_MOTION=0: spark statis,
609
633
  env dibaca saat dipakai), I25 (kursor CUP parkir di dalam blok ?2026 yang
610
634
  sama), I21 (konstanta idle form 80+10 dtk + teks peringatan).
611
- - `test/pty.test.ts` — I13/I17/I31/I28 via BYTE STREAM NYATA (harness PTY
612
- `test/helpers/pty-harness.ts`, CLI di pseudo-terminal sesungguhan +
613
- provider fake hermetic): boot → ?1049h + timer idle, turn penuh end-to-end,
614
- drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse dihitung dari
615
- LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM → restore + exit
616
- 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
635
+ - `test/pty.test.ts` — I13/I17/I31/I28 + UI-RENDER-01 via BYTE STREAM NYATA
636
+ (harness PTY `test/helpers/pty-harness.ts`, CLI di pseudo-terminal
637
+ sesungguhan + provider fake hermetic): boot → ?1049h + timer idle, terminal
638
+ terlalu kecil menolak alt-screen, turn penuh, teks Unicode kompleks pada
639
+ frame produksi, drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse
640
+ dihitung dari LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM →
641
+ restore + exit 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
617
642
  sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
618
643
  bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
619
644
  Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
@@ -629,18 +654,19 @@ panjang).
629
654
  skip senyap. Parser SGR dan selection SGR tetap terverifikasi terpisah di
630
655
  `test/prompt-engine.test.ts` dan `test/tui-app.test.ts` (fake TTY).
631
656
 
632
- ### Gap proteksi (terbukti, belum ditutup)
657
+ ### Peta proteksi dan gap tersisa
633
658
 
634
- Bagian ini menahan klaim yang **benar secara implementasi tetapi belum punya
635
- assertion** yang menjaganya. Menutup gap = menambah test; mengubah
636
- kata-kata di sini TIDAK menutup gap.
659
+ Baris berstatus "ditutup" menunjukkan bukti yang tersedia saat ini. Gap tersisa
660
+ tetap UNVERIFIED; keberadaan implementasi saja bukan bukti UAT.
637
661
 
638
662
  | Klaim | Status implementasi | Yang hilang |
639
663
  |---|---|---|
640
- | I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: scroll/abort tetap lolos saat `tooSmall()`) | Tidak ada assertion. `test/tui-app.test.ts` ("terminal menciut tengah sesi") hanya asserting bahwa ketikan diabaikan + `Ctrl+D` keluar. |
641
- | I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Kata "spacer" tidak muncul di berkas test mana pun — tak ada assertion tinggi-geometry maupun rendah. |
664
+ | I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: PgUp/PgDn dan Esc diintercept sebelum `tooSmall()`) | Ditutup: `test/tui-app.test.ts` membuktikan scroll posisi baca bertahan saat layar dipulihkan dan Esc memanggil abort; `Ctrl+D` tetap jalan keluar terakhir. |
665
+ | I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Ditutup: `test/tui-app.test.ts` meng-assert baris spacer dalam frame penuh 14 baris. |
642
666
  | I20 — lebar kotak popup tetap per permukaan | Terimplementasi | `test/tui-app.test.ts` menandai salah satu test-nya sebagai `(I20)`, padahal test itu milik I13 (status bar). Lebar popup diverifikasi di `test/tui-geometry.test.ts` + `test/dialog.test.ts`; label di `tui-app` menyesatkan. |
643
667
  | I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
644
668
  | I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
645
669
  | I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
646
- | I3 — tak ada byte stdout bocor selama alternate-screen | Terimplementasi (TUI menulis UI ke stderr; stdout khusus pipe/envelope) | Belum ada test PTY yang meng-assert "stream stdout kosong selama alt-screen aktif" (hanya fake-TTY). Juga: job `ci-windows` TIDAK pernah menjalankan `pty*.test.ts` — suite PTY hanya tercapai lewat glob `test/p*.test.ts` di job ubuntu. |
670
+ | I3 — kepemilikan frame tunggal selama alternate-screen | `App` merender frame ke stdout; `simple` quiet dan transient stderr ditahan selama layar dimiliki TUI | Ditutup untuk jalur yang diuji: `test/terminal-contract.test.ts` memastikan printer linear quiet tetap tidak menulis, `test/pty.test.ts` mengamati frame produksi, dan `test/writer-inventory.test.ts` mengunci daftar writer. Suite PTY berjalan pada CI Linux; Windows ConPTY tidak menjalankan seluruh kasus PTY. |
671
+ | UI-COMPAT-01 — startup TUI gagal | Non-TTY/terminal tak mampu menolak fullscreen tanpa fallback linear; diagnostik stderr dan exit 1 | Ditutup: `test/tui-startup-failure.test.ts` menguji CLI produksi via subprocess; `test/pty.test.ts` menguji terminal di bawah minimum tanpa `?1049h`. Exit code PTY hanya diklaim jika platform mengembalikan angka. |
672
+ | UI-RENDER-02 — exception render melewati teardown | `TuiApp.run()` melakukan cleanup idempoten di `finally`; write frame melempar ke owner | Ditutup untuk initial paint, writer frame, dan event repaint: `test/tui-app.test.ts` + `test/screen.test.ts` memverifikasi alt-screen, raw mode, listener, subscription, timer dan sync-update. Sinyal POSIX diperiksa terpisah; Windows melewati test sinyal POSIX. |
package/docs/agents.md CHANGED
@@ -5,14 +5,14 @@
5
5
 
6
6
  Sub-agent = instans agent dengan **context terpisah** dari parent: memory, signal, dan budget sendiri. Pool concurrency 3 — maksimum 3 sub-agent hidup sekaligus — dan abort-aware (mewarisi AbortSignal parent; parent batal → anak berhenti).
7
7
 
8
- Approval: `delegate_task` di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
8
+ Approval: `delegate_task` di-**ASK** di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. Di **AUTO**, delegasi berjalan otonom bila authorized (anak tetap ter-ceiling WorkMode parent, dipaksa explore read-only bila parent non-BUILD). **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
9
9
 
10
10
  ## Mode anak: `explore` / `plan`
11
11
 
12
12
  | Mode anak | Kemampuan |
13
13
  |---|---|
14
14
  | `explore` | Subset read-only (12 tool) — cari/pahami kode, kembalikan temuan |
15
- | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode/PM ketat** (`PLAN`/`DISCUSS`/`readonly`/`plan`/`ask`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `EXECUTE`×auto/allow-all**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
15
+ | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode ketat** (`PLAN`/`DISCUSS`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `BUILD`×AUTO**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
16
16
 
17
17
  Restriksi anak yang **selalu** berlaku: anak **tidak** bisa bersarang (`delegate_task` dibuang), tidak bisa `git_commit`, tidak menulis memory/todo, tidak memakai `bash_output`/`bash_kill` (job milik parent). Tool MCP runtime (`server.tool`) hanya muncul pada anak `plan` di bawah parent `EXECUTE`; pada `explore` maupun parent non-`EXECUTE`, daftar anak dibatasi ke `EXPLORE_TOOL_NAMES`. Plan-parent dipaksa explore saat mendelegasi.
18
18
 
@@ -1,34 +1,41 @@
1
1
  # Memilih Mode
2
2
 
3
- Satu pertanyaan, satu jawaban: **mode mana untuk tujuan saya?**
3
+ Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
4
+
5
+ 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/plánning), `BUILD` (implementasi).
6
+ 2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
7
+ 3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
8
+
9
+ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya.
4
10
 
5
11
  ## Kalau tujuan Anda X → gunakan Y
6
12
 
7
13
  | Saya ingin… | Gunakan | Karena |
8
14
  |---|---|---|
9
- |Memahami repo tanpa mengubah apa pun | `readonly` (atau `--tool-scope explore`) | Gerbang izin mengizinkan 18 tool baca (`READONLY_TOOLS`); model tetap hanya **melihat 12** tool baca (visibilitas `EXPLORE_TOOL_NAMES`) — tulis/bash/commit/delegasi ditolak di gerbang |
10
- | Minta agen membuat perubahan | `auto` (default) | Tulis terjail + bash aman langsung jalan; yang berisiko (commit, MCP, delegasi) tetap minta izin sekali |
11
- | Menyetujui setiap perubahan | `ask` | Tiap tool non-sepele menunggu jawaban; `todo`/`bash_output` tak ditanya (bookkeeping sendiri) |
12
- | Menyusun rencana tanpa eksekusi | `plan` | Baca + tulis rencana (`todo_write`) + delegasi yang dipaksa read-only; tanpa mutasi file/git/memori |
13
- | Otomasi/CI tanpa manusia | One-shot/`exec` + mode default | `ask_user`/gated otomatis ditolak di non-TTY (fail-closed, bukan gantung); hindari prompt yang butuh klarifikasi |
14
- | Otonom penuh di mesin sendiri | `allow-all` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
15
+ | Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal (16 tool baca); network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
16
+ | Minta agen membuat perubahan | `BUILD` + `AUTO` (default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
17
+ | Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
18
+ | Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
19
+ | Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
20
+ | Otonom penuh di mesin sendiri | `BUILD`+`AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
15
21
 
16
22
  ## Rule of thumb
17
23
 
18
- 1. **Default `auto` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
19
- 2. **`readonly` untuk baca, `plan` untuk berpikir.** Bedanya: `plan` boleh menulis rencana dan mendelegasikan penelahan; keduanya tak menyentuh file/git/memori Anda.
20
- 3. **`ask` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
21
- 4. **CI = non-interaktif = tanpa approval.** Jangan desain pipeline yang bergantung pada `ask_user` atau commit oleh agent; commit tetap keputusan manusia/Workflow.
22
- 5. **`allow-all` mematikan prompt, bukan batas.** Path jail dan pola bash berbahaya tetap menolak. Pasangkan dengan sandbox + budget bila otonom.
24
+ 1. **Default `BUILD`+`AUTO` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
25
+ 2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
26
+ 3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
27
+ 4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
28
+ 5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
23
29
 
24
30
  ## Tradeoff yang jujur
25
31
 
26
32
  - Semakin otonom → semakin cepat, semakin besar blast radius bila model salah paham. Tidak ada mode yang membuat model lebih bijak — mode hanya mengatur **apa yang boleh terjadi**.
27
33
  - `allowlist` (otomatis saat tanpa sandbox OS) paling ketat untuk shell, tetapi model tetap bisa menulis file via tool terjail — pahami beda sumbunya: allowlist membatasi *perintah*, jail membatasi *file*.
28
- - Ganti mode kapan pun: flag saat start, `/mode` atau Shift+Tab saat TUI berjalan.
34
+ - Ganti mode kapan pun: flag saat start, `Tab`/`Shift+Tab` atau `/mode`+`/work-mode` saat TUI berjalan.
29
35
 
30
36
  ## Lanjut
31
37
 
32
38
  - [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
33
39
  - [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
34
40
  - [Otomasi & CI](exec.md) — batasan headless.
41
+ - [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
package/docs/cli.md CHANGED
@@ -43,10 +43,10 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
43
43
  | `--budget <usd>` | Batas biaya sesi; warn 80%, exit/break bila lewat; cost tak dikenal + pemakaian = over (fail-closed default) |
44
44
  | `--budget-strict` | Penegasan eksplisit fail-closed di atas (back-compat) |
45
45
  | `--tool-scope <s>` | `full` (default) \| `explore` = subset read-only 12 tool |
46
- | `--plan` | Read-only plan mode |
47
- | `--allowlist` | Bash hanya perintah aman |
48
- | `--ask` | Tanya persetujuan setiap tool |
49
- | `--allow-all` | Nonaktifkan semua sandbox (path jail tetap aktif) |
46
+ | `--plan` | **Deprecated** — alias untuk `--work-mode PLAN` (read-only planning) |
47
+ | `--allowlist` | Bash hanya perintah aman (tool-access policy warisan) |
48
+ | `--ask` | Tanya persetujuan setiap tool (human-supervised) |
49
+ | `--allow-all` | Profil akses privileged (path jail + bash-guard tetap aktif) |
50
50
  | `--model <name>` | Override model (`providerId::model` paksa provider) |
51
51
  | `--provider <id>` | Paksa provider id agnostik |
52
52
  | `--resume <id>` | Lanjutkan sesi (full history, bukan dump teks) |
@@ -56,21 +56,21 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
56
56
  | `--max-steps <n>` | Batas langkah tool (default 50) |
57
57
  | `--context-window <n>` | Ukuran jendela konteks (token) |
58
58
  | `--session <id>` | ID sesi (default random, disanitasi) |
59
- | `--work-mode <m>` | `DISCUSS` \| `PLAN` \| `EXECUTE` (default). **Lapis intent di atas** permission mode: `DISCUSS` = read-only penuh, `PLAN` = hanya tool rencana, `EXECUTE` = tanpa ceiling tambahan. Tidak pernah memperluas kewenangan permission mode; permission mode tetap yang memutuskan allow/deny per tool. Lihat [TUI](repl.md) untuk `/work-mode` (aksi operator saat sesi berjalan) |
59
+ | `--work-mode <m>` | `DISCUSS` \| `PLAN` \| `BUILD` (default). **Operating mode**: `DISCUSS` = investigasi read-only, `PLAN` = analisis/planning, `BUILD` = implementasi (identitas internal `EXECUTE`). Persetujuan (`AUTO`/`ASK`) dipisah; tool availability mengikuti ceiling WorkMode. Lihat [TUI](repl.md) untuk `/work-mode` |
60
60
  | `--enable-scheduler` | Opt-in scheduler otonom (default **off**). Tanpa flag ini, scheduler tidak dibangun sama sekali dan `/scheduler` menjawab "not enabled". Eksekusi manual saja lewat `/scheduler run` — tidak ada timer; turn otonom bersifat read-only. Lihat `/scheduler status` dan `/scheduler stop` |
61
61
  | `--runtime <mode>` | `off` (default) \| `constructed` \| `owned`. Arsitektur eksekusi: `off` = perilaku sekarang, tak berubah; `constructed` = runtime + jurnal durable dibangun, turn masih jalan jalur lama; `owned` = setiap turn di-admit lewat runtime (kernel + jurnal durable) dan admission yang ditolak menjalankan tak apa pun. Nilai tak dikenal = `off` |
62
62
 
63
- Di TUI, **Shift+Tab** memutar permission (`auto` → `ask` → `plan` → `allowlist`) dan benar-benar mengubah keputusan, bukan label. Di baris kosong, **Tab** juga memutar mode (`auto` → `ask` → `plan` → `allowlist`). Shift+Tab **tidak** memutar WorkMode — itu lapis intent terpisah (`/work-mode`).
63
+ Di TUI, **Tab** memutar WorkMode (`DISCUSS` → `PLAN` → `BUILD`) dan **Shift+Tab** meng-toggle PermissionMode (`AUTO` ↔ `ASK`). `/mode <AUTO|ASK>` mengubah persetujuan; `/work-mode <DISCUSS|PLAN|BUILD>` mengubah operating mode. Footer selalu menampilkan kedua lapis (`BUILD · AUTO`).
64
64
 
65
65
  ## Kapan memakai apa
66
66
 
67
67
  | Tujuan | Pakai |
68
68
  |---|---|
69
- | Kerja harian biasa | Default (`auto`) — tulis aman langsung jalan, yang berisiko minta izin |
70
- | Repo asing / perintah belum dipahami | `--ask`, jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
71
- | Review tanpa eksekusi | `--plan` (+ `--tool-scope explore` bila ingin subset baca 12 tool) |
72
- | CI tanpa manusia | `exec --json` + `--budget`/`--max-steps`; hindari prompt yang butuh klarifikasi |
73
- | Otonom penuh di mesin sendiri | `--allow-all` + `--sandbox docker` (atau OS) + `--budget` |
69
+ | Kerja harian biasa | Default (`BUILD` + `AUTO`) — tulis/eksekusi/commit/delegasi jalan otonom bila authorized |
70
+ | Repo asing / perintah belum dipahami | `--ask` (`BUILD` + `ASK`), jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
71
+ | Review/analisis tanpa eksekusi | `--work-mode PLAN` (atau `--work-mode DISCUSS` untuk investigasi read-only murni) |
72
+ | CI tanpa manusia | `exec --json` + `--budget`/`--max-steps`; `AUTO` menolak `ask_user` deterministik |
73
+ | Otonom penuh di mesin sendiri | Default `BUILD`+`AUTO`; isolasi tambahan `--sandbox docker` (atau OS) + `--budget` |
74
74
  | Model mahal tak terkendali | `--budget 0.50` + `--budget-strict` + `pricing sync` |
75
75
 
76
76
  Detail alasan tiap mode di [Memilih Mode](choosing-mode.md).
@@ -12,10 +12,10 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
12
12
  | Variabel | Fungsi |
13
13
  |---|---|
14
14
  | `MINICODE_TIMEOUT_MS` | Default timeout (ms) bila `--timeout` tidak diset; `0` = Infinity |
15
- | `MINICODE_PLAN` | `1` → mode plan (tanpa `--plan`) |
16
- | `MINICODE_PERMISSION` | `allowlist` → mode permission |
15
+ | `MINICODE_PLAN` | `1` → alias warisan `--work-mode PLAN` (tanpa `--plan`) |
16
+ | `MINICODE_PERMISSION` | `allowlist` → tool-access policy bash (profil warisan) |
17
17
  | `MINICODE_TOOL_SCOPE` | `explore` → subset read-only 12 tool (sama `--tool-scope explore`) |
18
- | `MINICODE_WORK_MODE` | `DISCUSS` \| `PLAN` \| `EXECUTE` → work mode (lapis intent di atas permission mode; sama `--work-mode`; flag menang atas env; nilai tak dikenal = EXECUTE) |
18
+ | `MINICODE_WORK_MODE` | `DISCUSS` \| `PLAN` \| `BUILD` → operating mode (sama `--work-mode`; `BUILD` alias `EXECUTE` internal; flag menang atas env; nilai tak dikenal = BUILD/EXECUTE) |
19
19
  | `MINICODE_HOOKS` | `1` → jalankan hook `pre/post-run` dari `~/.minicode/hooks/*.js` & `.minicode/hooks/*.js` (konteks di env `MINICODE_HOOK_CTX`; env hook disanitasi tanpa secret; dilewati bila sesi dibatalkan) |
20
20
  | `MINICODE_SESSION_TTL_DAYS` | TTL sesi (default 30; `0` = selamanya) |
21
21
  | `MINICODE_HOME` | Override home untuk DB lokal/global (sessions + vector); default `~` |
@@ -63,22 +63,24 @@ Docker **tidak** dipakai otomatis meski tersedia — menarik image tanpa diminta
63
63
  ## Update & uninstall
64
64
 
65
65
  Membuka `minicode` interaktif (TTY) selalu cek versi terbaru ke registry:
66
- bila ada, paket di-install (`npm install -g minicode-ai@latest`) lalu
67
- minicode restart sendiri ke versi baru — tanpa update manual. Berlaku hanya
68
- untuk salinan ter-install (checkout source tidak disentuh) dan tidak pernah
69
- memblokir: install gagal/offline = lanjut versi lama + pesan manual.
66
+ versi SemVer tepat yang ditemukan diverifikasi dahulu lewat instalasi sementara
67
+ dan `npm audit signatures` (signature registry + provenance). Skrip instalasi
68
+ paket dimatikan; hanya graph tanpa dependency runtime yang diterima. Setelah
69
+ itu versi yang sama dipasang dari registry resmi, versi di package terpasang
70
+ dibaca ulang, lalu minicode restart sendiri. Ketidakcocokan mencoba memulihkan
71
+ versi sebelumnya; bila pemulihan gagal, proses berhenti agar tidak berjalan
72
+ dengan instalasi campuran. Berlaku hanya untuk salinan ter-install (checkout
73
+ source tidak disentuh). Npm lama, paket tanpa bukti signature/provenance,
74
+ offline, atau install gagal menahan auto-update dan memberi instruksi manual.
70
75
  One-shot, `exec`, pipe, dan CI hanya menampilkan notifikasi (tanpa install).
71
76
 
72
- > Model ancaman yang jujur: auto-update mengeksekusi kode dari registry
73
- > tanpa verifikasi tanda tangan client-side (attestasi Sigstore npm butuh
74
- > infrastruktur verifikasi di luar jangkauan CLI zero-dep — sudah diteliti,
75
- > bundelnya tak membawa identitas repo yang bisa dicek offline). Percayakan
76
- > TLS registry + rilis hanya dari CI repo ini; yang butuh jaminan lebih,
77
- > matikan auto-update (`MINICODE_AUTO_UPDATE=0`) dan update manual setelah
78
- > memeriksa rilis di GitHub.
77
+ > Verifikasi memakai kemampuan npm, bukan verifier Sigstore yang dibundel
78
+ > MiniCode. Gagal-verifikasi selalu menghentikan update otomatis. Pemilik tetap
79
+ > dapat mematikan jalur ini (`MINICODE_AUTO_UPDATE=0`) dan mengelola update
80
+ > manual sesuai kebijakan organisasinya.
79
81
 
80
82
  ```bash
81
- npm update -g minicode-ai # manual, bila auto-update dimatikan
83
+ npm install -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
82
84
  minicode sync # refresh model baru dari semua provider
83
85
  minicode pricing sync # refresh cache harga (3.162 model, ~213 KB)
84
86
  ```
package/docs/glossary.md CHANGED
@@ -10,7 +10,7 @@ Istilah Minicode yang punya makna spesifik. Dokumentasi berbahasa Indonesia deng
10
10
  | **Tool scope** | `full` (semua 37) atau `explore` (subset read-only 12 tool) — flag `--tool-scope` |
11
11
  | **Permission mode** | Keputusan siapa yang memutuskan aksi: `auto / readonly / plan / allowlist / ask / allow-all` |
12
12
  | **Gate** | Tool wajib persetujuan manusia saat TTY; non-TTY selalu tolak (mis. `git_commit`, MCP, `delegate_task`) |
13
- | **Path jail** | Pembatasan akses file ke workspace (realpath + symlink + TOCTOU `O_NOFOLLOW`); aktif bahkan `--allow-all` |
13
+ | **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` |
14
14
  | **Bash-guard** | Normalisasi + blokir pola bash berbahaya sebelum eksekusi (quote-split, indirection, wrapper) |
15
15
  | **Sandbox OS** | bubblewrap (Linux) / seatbelt (macOS) — otomatis bila tersedia |
16
16
  | **Sandbox Docker** | Container ephemeral `--network none`, 512m, 1 CPU, `node:22-alpine` |
package/docs/mcp-lsp.md CHANGED
@@ -30,7 +30,7 @@ Keamanan HTTP: host privat ditolak kecuali `--allow-private` (penjaga sama denga
30
30
 
31
31
  Izin: semua MCP bertitik selalu di-gate — `auto` minta konfirmasi sekali per tool (`[a] Always` persist ke allowlist); `readonly`/`plan`/`allowlist` menolak. Tanpa wildcard auto-allow (proteksi supply-chain).
32
32
 
33
- Model kepercayaan: permission hanya kontrol *pemanggilan*. Capability di balik server (filesystem, network, proses, API) tak bisa diketahui statis — anggap setiap `mcp_call` external capability arbitrer. Pembatalan hentikan penungguan, tapi tidak bunuh proses stdio maupun batalkan efek yang sudah terjadi.
33
+ Model kepercayaan: permission hanya kontrol *pemanggilan*. Capability di balik server (filesystem, network, proses, API) tak bisa diketahui statis — anggap setiap `mcp_call` external capability arbitrer. Pembatalan menghentikan penungguan lokal, tetapi tidak membuktikan bahwa server berhenti atau membatalkan efek yang sudah diterima. Jika koneksi terputus setelah request dikirim, tool mengembalikan error `outcome unknown`; periksa state remote sebelum mencoba lagi.
34
34
 
35
35
  Ekspos balik (stdio saja — tanpa mode HTTP, jadi tak ada permukaan jaringan):
36
36
 
@@ -61,11 +61,17 @@ Fuzz membangkitkan varian dari transformasi yang shell anggap setara (quote-spli
61
61
  | `--sandbox docker` | Container ephemeral (`--network none`, 512m, 1 CPU, `node:22-alpine`) |
62
62
  | `--sandbox docker` tapi daemon mati | TOLAK sebelum jalan (fail-closed) + cara opt-in fallback eksplisit; tidak pura-pura terisolasi |
63
63
 
64
+ Container mendapat nama acak per-run. Saat batas waktu habis atau tool dibatalkan,
65
+ runner meminta daemon menjalankan `docker rm --force` dengan timeout cleanup
66
+ 5 detik sebelum menghentikan penunggu CLI. Output membedakan cleanup yang
67
+ dikonfirmasi daemon dari yang tidak terkonfirmasi. Ini tidak membatalkan efek
68
+ workspace yang sudah terjadi sebelum container dihentikan.
69
+
64
70
  `MINICODE_SANDBOX_STRICT=1` = tak pernah fallback host (redundan dengan default fail-closed untuk request eksplisit, tetap dihormati). `MINICODE_SANDBOX_ALLOW_FALLBACK=1` = satu-satunya jalan fallback host yang sadar bila backend tak tersedia. `MINICODE_SANDBOX_IMAGE` ganti image (default `node:22-alpine` hanya bawa node). `code_run` selalu lewat sandbox runner dan menolak bila backend tak tersedia.
65
71
 
66
72
  ## Lapisan lain
67
73
 
68
- - **Path jail** realpath-based + symlink `realpath` di permission layer; `.env`/`.git/config`/`node_modules`/hive Windows deny; `.minicode/` terkunci penuh untuk tool tulis berdasarkan target NYATA (realpath best-effort `isOwnedStateReal` — junction/symlink internal ke `.minicode/` ikut ditahan; kecuali restore `.trash/` + skrip `hooks/`); bash-guard menahan PEMBUATAN link yang operannya sensitif/owned-state; TOCTOU `O_NOFOLLOW` (`src/lib/safe-open.ts`: `resolveSafePath` untuk penulis, `safeOpenRead` untuk pembaca; POSIX-only, Windows pre-check).
74
+ - **Path jail** realpath-based + symlink `realpath` di permission layer; `.env`/`.git/config`/`node_modules`/hive Windows deny; `.minicode/` terkunci penuh untuk tool tulis berdasarkan target NYATA (realpath best-effort `isOwnedStateReal` — junction/symlink internal ke `.minicode/` ikut ditahan; kecuali restore `.trash/` + skrip `hooks/`); bash-guard menahan PEMBUATAN link yang operannya sensitif/owned-state. Untuk pembacaan, `safeOpenRead` memeriksa boundary ulang setelah stat dan mencocokkan `dev+ino` dari handle yang terbuka; `O_NOFOLLOW` juga dipakai pada POSIX. Stress test symlink tetap skip bila host tidak memberi privilege membuat symlink.
69
75
  - **Env scrub** `sanitizeSpawnEnv`: strip kata-kunci kredensial dari merge final; `GITHUB_WORKSPACE`/`REDIS_HOST`/`AWS_REGION` tetap ada, `GITHUB_TOKEN`/`AWS_SECRET_ACCESS_KEY`/`DATABASE_URL` tetap di-strip.
70
76
  - **web_fetch/web_search**: redirect manual 5 hop + DNS pinning 30 dtk + body 2 MB.
71
77
  - **Secret scrubber**: `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` di-redact sebelum ke LLM (read_file/bash/grep) — tanpa whitelist kata.
@@ -58,7 +58,7 @@ Minicode **tidak menyediakan tool** untuk (terverifikasi di `src/tools/`):
58
58
  - `git reset`, `amend`, `rebase`, `checkout`, `branch -D`, `stash drop`
59
59
  - Eksekusi remote / deploy bawaan
60
60
 
61
- Catatan jujur: operasi itu tetap BISA diketik lewat `bash` (tunduk pada bash-guard + jail, BUKAN larangan). Dan `git` via bash menjalankan konfigurasi repo apa adanya (hook/filter/driver milik repo) — beda dengan tool `git_*` yang dinetralkan. Di repo tak-terpercaya, utamakan tool `git_status`/`git_diff`/`git_log` dan pahami trust stock-git sebelum `add`/`checkout` via bash.
61
+ Catatan jujur: operasi itu tetap BISA diketik lewat `bash` (tunduk pada bash-guard + jail, BUKAN larangan). `git` via bash menjalankan konfigurasi repo apa adanya (hook/filter/driver milik repo). Tool baca `git_*` dinetralkan; `git_commit` menolak sebelum staging bila filter Git terkonfigurasi. Di repo tak-terpercaya, utamakan tool baca dan tinjau konfigurasi sebelum memakai Git manual.
62
62
 
63
63
  ## Recovery
64
64
 
@@ -76,7 +76,7 @@ Kejujuran yang disengaja: crash ambiguity TETAP MUNGKIN (filesystem dan database
76
76
 
77
77
  ## Limitations
78
78
 
79
- - **Repo hooks/filter/driver:** `git` via bash mengeksekusinya (semantik stock-git); tool `git_*` tidak.
79
+ - **Repo hooks/filter/driver:** `git` via bash mengeksekusinya (semantik stock-git); tool baca `git_*` menetralkan filter, sedangkan `git_commit` menolak bila menemukan filter terkonfigurasi.
80
80
  - **Bash arbitrer:** guard adalah analisis statis; substitusi dinamis (`$(curl …)`) butuh sandbox OS/docker untuk isolasi nyata.
81
81
  - **Efek eksternal MCP:** setelah terjadi, tak bisa dibatalkan dari sini.
82
82
  - **Provider/network:** data melewati provider pilihan Anda; Minicode tak menambahkan transmisi sendiri.
package/docs/security.md CHANGED
@@ -37,10 +37,16 @@
37
37
  | `for /f %i in (.env) do @echo %i` (pembaca bawaan cmd.exe) | `for` adalah loop, bukan utilitas → tidak ada di `READERS`, sehingga target berkasnya tak diperiksa sama sekali | ditolak: set berkas `for /f … in (…)` diekstrak (`forFileSets`) dan diperiksa seperti argumen pembaca (temuan F3) |
38
38
 
39
39
  2. **Allowlist** (`--allowlist`, dan default bila tanpa sandbox OS): hanya bentuk read/build — `git status/diff/log/branch/show`, `bun test/run/x tsc`, `npm run/exec`, `npx`, `ls dir cat type head tail wc grep rg find which echo pwd`. Tulis via shell ditahan; pakai `write_file`/`edit` yang ter-jail. `npm exec`/`npx`/`bun run`/`bun x` tak boleh ekspansi shell/redirection. `git --no-index/--exec-path/--upload-pack/--receive-pack`, transport `ext::`, dan `GIT_EXTERNAL_DIFF`/`GIT_CONFIG_*` inline ditolak guard (git sebagai pelarian jail).
40
- 3. **Path jail** realpath-based + symlink check + TOCTOU `O_NOFOLLOW`; `.env`/`.git/config`/`node_modules`/hive Windows (`system32\config\sam|system|security|software`, `ntds.dit`) deny; berlaku bahkan `--allow-all`.
40
+ 3. **Path jail** realpath-based + symlink check; pembaca membuka target canonical, memakai `O_NOFOLLOW` pada POSIX, lalu mencocokkan `dev+ino` antara stat sebelum open dan handle setelah open (termasuk Windows). `.env`/`.git/config`/`node_modules`/hive Windows (`system32\config\sam|system|security|software`, `ntds.dit`) deny; berlaku bahkan `--allow-all`.
41
41
  4. **Env scrub** `sanitizeSpawnEnv`: strip kata-kunci kredensial dari merge final. `GITHUB_WORKSPACE`/`GITHUB_REF`/`GOOGLE_CHROME_PATH`/`REDIS_HOST`/`AWS_REGION` **tetap ada** (pernah terhapus dan memecahkan build CI), sementara `GITHUB_TOKEN`/`AWS_SECRET_ACCESS_KEY`/`DATABASE_URL` di-strip. Bila non-rahasia ikut hilang, itu bug — laporkan nama variabelnya.
42
42
  5. **web_fetch/web_search**: redirect manual ≤5 hop + DNS pinning 30 dtk + body cap 2 MB. Host privat ditolak (sama untuk MCP HTTP).
43
43
 
44
+ `grep` memakai ripgrep bila tersedia. Biner di-resolve dari PATH absolut yang
45
+ tepercaya, environment child disanitasi, dan config eksternal dinonaktifkan
46
+ (`--no-config`, tanpa `RIPGREP_CONFIG_PATH`). Config ripgrep mendukung
47
+ preprocessor yang mengeksekusi program per berkas; karena itu tool pencarian
48
+ tidak mewarisi konfigurasi tersebut.
49
+
44
50
  ## Prompt injection
45
51
 
46
52
  - Output verify dibungkus fence agar instruksi di error build tidak diikuti model.
package/docs/tools.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Referensi lengkap tool Minicode: filesystem, search, exec, git, web, memory, plan, agents, MCP, LSP.
4
4
 
5
- Pilih tool ini ketika: **file** untuk baca/tulis presisi (bukan `cat` via bash); **search** untuk menemukan kode (bukan `grep` via bash); **bash** untuk perintah yang memang butuh shell; **git tool** untuk status/diff/log/commit (bukan `git` mentah — tool dinetralkan dari hook/filter repo); **web** untuk sumber publik; **memory** untuk fakta lintas sesi (bukan tempelan prompt); **delegate** untuk penelahan paralel yang hasilnya diverifikasi parent.
5
+ Pilih tool ini ketika: **file** untuk baca/tulis presisi (bukan `cat` via bash); **search** untuk menemukan kode (bukan `grep` via bash); **bash** untuk perintah yang memang butuh shell; **git tool** untuk status/diff/log/commit (bukan `git` mentah — operasi baca dinetralkan dan commit menolak custom filter repo); **web** untuk sumber publik; **memory** untuk fakta lintas sesi (bukan tempelan prompt); **delegate** untuk penelahan paralel yang hasilnya diverifikasi parent.
6
6
 
7
7
  Daftar pasti kapan pun:
8
8
 
@@ -23,7 +23,7 @@ bun -e "import {allTools} from './src/tools/index.ts'; console.log(allTools.map(
23
23
  | `apply_patch` | Blok SEARCH/REPLACE multi-hunk ala Aider | Satu call banyak patch |
24
24
  | `move_file` | Pindah/rename atomik | Dest yang ada dibackup ke trash dulu (catat path). Dijail di permission layer juga |
25
25
  | `delete_file` | Soft-delete ke `.minicode/.trash/` | Undo via `move_file`. Cap 100 terbaru, gitignored. Shared helper `src/lib/trash.ts` |
26
- | `read_image` | Gambar → konteks model | Base64 utuh + lapor `(bytes mime, tokens)` via `estimateImageTokens`. Cap file-size 2 MB. TOCTOU-safe (`safeOpenRead` + `handle.stat`) |
26
+ | `read_image` | Gambar → konteks model | Base64 utuh + lapor `(bytes mime, tokens)` via `estimateImageTokens`. Cap file-size 2 MB. Pembukaan memeriksa target canonical, boundary ulang, identitas handle `dev+ino`, dan hardlink (`safeOpenRead`) |
27
27
 
28
28
  Contoh paging:
29
29
 
@@ -66,7 +66,7 @@ Batas `BASH_BACKGROUND_MAX_JOBS`; semua job mati saat CLI keluar.
66
66
  | `git_status` | `status --porcelain + diff --stat + log -10` | cwd jail |
67
67
  | `git_diff` | `diff` unstaged atau `--staged` | — |
68
68
  | `git_log` | `log --oneline -n` | — |
69
- | `git_commit` | Commit saja | **Di-gate** seperti `delegate_task` (TTY = minta sekali, non-TTY = tolak; `readonly/plan/allowlist` = tolak). Sub-agent tidak mendapatkannya. Yang sengaja tidak ada: push/amend/reset/rebase/checkout/branch -D/stash drop. Pesan via `-m` tunggal agar `$()`/backtick tidak dieksekusi; `git add -- <paths>` agar file `-weird.txt` tidak jadi flag |
69
+ | `git_commit` | Commit saja | **Di-gate** seperti `delegate_task` (TTY = minta sekali, non-TTY = tolak; `readonly/plan/allowlist` = tolak). Menolak sebelum staging jika config Git efektif memuat custom filter; tinjau filter terpercaya lalu lakukan commit manual. Sub-agent tidak mendapatkannya. Yang sengaja tidak ada: push/amend/reset/rebase/checkout/branch -D/stash drop. Pesan via `-m` tunggal agar `$()`/backtick tidak dieksekusi; `git add -- <paths>` agar file `-weird.txt` tidak jadi flag |
70
70
 
71
71
  ## Web
72
72
 
@@ -97,7 +97,7 @@ Batas `BASH_BACKGROUND_MAX_JOBS`; semua job mati saat CLI keluar.
97
97
  | Tool | Spec | Catatan |
98
98
  |---|---|---|
99
99
  | `mcp_list` | `tools/list` + `resources/list` + `prompts/list` | Read-only, tidak di-gate. Panggil dulu |
100
- | `mcp_call` | `tools/call` | Di-gate. 1 approval = 1 call. Jalan di luar policy minicode |
100
+ | `mcp_call` | `tools/call` | Di-gate. 1 approval = 1 call. Jalan di luar policy minicode. Abort/timeout setelah request dikirim dilaporkan sebagai `outcome unknown`; periksa state server sebelum retry |
101
101
  | `mcp_read` | `resources/read` | Di-gate **meski read-only** (konten pihak ketiga = jalur prompt-injection). Biner diganti penanda ukuran |
102
102
  | `mcp_prompt` | `prompts/get` | Di-gate, server merender argumen |
103
103
 
@@ -29,6 +29,22 @@ bun run gate:eval --results bench/live.json --min-rate 0.8 --max-median-tokens 8
29
29
  bun bench/eval-gate.ts --results bench/results.json --min-rate 1 --max-median-tokens 5000 --observe-tokens # observasi: token tak menggagalkan (2–3 run pertama sebelum ambang dikunci)
30
30
  ```
31
31
 
32
+ CI menjalankan `test/eval-gate.test.ts` untuk menguji evaluator secara
33
+ deterministik tanpa provider, lalu menjalankan CLI `gate:eval` terhadap output
34
+ `bench:smoke` dan memastikan hasil palsu ditolak. `bench:smoke` hanya menguji
35
+ wiring harness; hanya hasil yang secara eksplisit berlabel `fake: false` dapat
36
+ dinilai, sehingga hasil fake atau artefak lama tanpa asal provider dinyatakan
37
+ bukan bukti kualitas. Evaluasi
38
+ kualitas live tetap harus memakai hasil provider nyata yang tersimpan, serta
39
+ anggaran/provider yang dipilih operator. CI PR dan publish tidak menjalankan
40
+ provider berbayar atau memakai rahasia model; evaluasi live tetap manual karena
41
+ hasil, model, dan anggaran harus dipilih operator secara eksplisit.
42
+
43
+ Skor deterministik menggunakan total langkah aktual seluruh run dibanding
44
+ total batas langkah yang disediakan. Nilai ini berasal dari `usage.steps` saat
45
+ run selesai, atau event `step:started` jika run berakhir dengan error; batas
46
+ konfigurasi tidak lagi dipakai sebagai pengganti langkah aktual.
47
+
32
48
  Metrik: resolve rate, steps, token, cost, durasi, memoryHits + delta vs run sebelumnya. Hasil `bench/results.json` (`--out` untuk path lain). Tiap run gagal membawa kelas (`VERIFY_FAIL`/`MAX_STEPS`/`NO_PROGRESS`/`ABORT`) + distribusi global di akhir run; kartu metodologi + log observasi di `bench/HARNESS-CARD.md`.
33
49
 
34
50
  Setiap run memakai `MINICODE_HOME` hermetic sendiri (DB/memory/sesi global tak bocor antar run dan tak menyentuh `~/.minicode` operator). Task boleh membawa `seedMemory`: fakta yang di-seed ke memory run itu — task `follow-convention` hanya lolos bila agen membaca fakta tersebut, sehingga `bun bench/runner.ts --memory on` vs `--memory off` mengukur nilai memory secara diferensial (bukan klaim).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.14.0",
3
+ "version": "0.14.2",
4
4
  "description": "Coding agent CLI built on the frozen MiniCore runtime — tools, MCP, LSP, sandbox, shadow-git checkpoints",
5
5
  "type": "module",
6
6
  "private": false,
@@ -49,7 +49,6 @@
49
49
  "vendor/minicore/package.json",
50
50
  "vendor/minicore/VENDOR.md",
51
51
  "README.md",
52
- "CHANGELOG.md",
53
52
  "LICENSE",
54
53
  "docs/OUTPUT_ARCHITECTURE_AUDIT.md",
55
54
  "docs/OUTPUT_EVENT_MODEL.md",
@@ -57,7 +56,6 @@
57
56
  "docs/OUTPUT_PROTOCOL_SPEC.md",
58
57
  "docs/OUTPUT_RENDERING_SPEC.md",
59
58
  "docs/OUTPUT_UX_RULES.md",
60
- "docs/PLAN_UIUX_V6.md",
61
59
  "docs/TERMINAL_CONTRACT.md",
62
60
  "docs/agents.md",
63
61
  "docs/architecture.md",
@@ -1,5 +1,6 @@
1
- import { readFile, realpath } from "node:fs/promises"
1
+ import { realpath } from "node:fs/promises"
2
2
  import { isAbsolute, relative, resolve } from "node:path"
3
+ import { safeReadFileCapped } from "../lib/safe-open.ts"
3
4
  import { isPathOutsideRoot, isSensitive } from "../policy/jail.ts"
4
5
 
5
6
  const MAX_INJECT = 2_000
@@ -26,9 +27,9 @@ export async function resolveMentionContent(
26
27
  const [real, realRoot] = await Promise.all([realpath(abs), realpath(cwd)])
27
28
  if (isPathOutsideRoot(real, realRoot) || isSensitive(real))
28
29
  return { ok: false, reason: "rejected (jail)" }
29
- const txt = await readFile(real, "utf8")
30
+ const { text: txt, truncated } = await safeReadFileCapped(real, realRoot, MAX_INJECT)
30
31
  const rel = relative(realRoot, real).replace(/\\/g, "/")
31
- const body = txt.length > MAX_INJECT ? `${txt.slice(0, MAX_INJECT)}\n… (truncated)` : txt
32
+ const body = truncated ? `${txt}\n… (truncated: first ${MAX_INJECT} bytes)` : txt
32
33
  return { ok: true, content: `\n[file: ${rel}]\n${body}\n[/file]\n` }
33
34
  } catch {
34
35
  return { ok: false, reason: "file not found" }