minicode-ai 0.14.6 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +6 -4
  2. package/cli/args.ts +20 -8
  3. package/cli/commands/exec.ts +17 -14
  4. package/cli/commands/openwork.ts +1 -1
  5. package/cli/commands.ts +39 -23
  6. package/cli/index.ts +29 -7
  7. package/cli/model-manager.ts +1 -1
  8. package/cli/router.ts +22 -9
  9. package/cli/setup.ts +77 -35
  10. package/cli/tui.ts +179 -25
  11. package/docs/CONTROL-PLANE-MAP.md +7 -5
  12. package/docs/OUTPUT_EVENT_MODEL.md +4 -3
  13. package/docs/OUTPUT_PROTOCOL_SPEC.md +1 -1
  14. package/docs/OUTPUT_RENDERING_SPEC.md +16 -4
  15. package/docs/OUTPUT_UX_RULES.md +38 -32
  16. package/docs/P14_OPEN_WORK.md +290 -0
  17. package/docs/README.md +1 -1
  18. package/docs/SUMMARY.md +36 -22
  19. package/docs/TERMINAL_CONTRACT.md +89 -17
  20. package/docs/UI_RENDER_PIPELINE.md +47 -8
  21. package/docs/agents.md +1 -1
  22. package/docs/architecture.md +10 -8
  23. package/docs/autonomous-scheduler.md +142 -0
  24. package/docs/choosing-mode.md +4 -2
  25. package/docs/cli.md +11 -9
  26. package/docs/concepts.md +5 -5
  27. package/docs/config-providers.md +3 -3
  28. package/docs/config.md +1 -1
  29. package/docs/contributing.md +7 -9
  30. package/docs/environment.md +8 -5
  31. package/docs/getting-started.md +5 -5
  32. package/docs/mcp-lsp.md +2 -2
  33. package/docs/memory-sessions.md +3 -3
  34. package/docs/policy-sandbox.md +7 -4
  35. package/docs/pricing-budget.md +3 -3
  36. package/docs/quickstart.md +1 -1
  37. package/docs/repl.md +11 -8
  38. package/docs/security-model.md +4 -2
  39. package/docs/security.md +9 -8
  40. package/docs/skills.md +2 -2
  41. package/docs/terminal.md +10 -2
  42. package/docs/tools.md +4 -4
  43. package/docs/troubleshooting.md +3 -3
  44. package/docs/verify-benchmark.md +0 -3
  45. package/package.json +9 -18
  46. package/scripts/vendor-overlays/minicode-context.patch +1 -1
  47. package/src/app/mentions.ts +1 -1
  48. package/src/app/rag-layer.ts +11 -2
  49. package/src/app/session.ts +128 -10
  50. package/src/constants.ts +32 -1
  51. package/src/daemon/client.ts +11 -6
  52. package/src/daemon/control.ts +2 -9
  53. package/src/daemon/resource.ts +5 -4
  54. package/src/hooks/run.ts +5 -6
  55. package/src/lib/keystore.ts +11 -9
  56. package/src/lib/net.ts +8 -3
  57. package/src/lib/safe-open.ts +29 -5
  58. package/src/lib/trusted-exec.ts +4 -1
  59. package/src/lsp/client.ts +9 -10
  60. package/src/mcp/http-transport.ts +1 -1
  61. package/src/mcp/server.ts +17 -7
  62. package/src/memory/files.ts +2 -1
  63. package/src/memory/vector.ts +25 -16
  64. package/src/policy/bash-guard.ts +58 -16
  65. package/src/policy/bpe.ts +110 -0
  66. package/src/policy/compaction.ts +139 -22
  67. package/src/policy/consequence-engine.ts +3 -3
  68. package/src/policy/context-window.ts +43 -1
  69. package/src/policy/context.ts +50 -12
  70. package/src/policy/jail.ts +48 -3
  71. package/src/policy/no-progress.ts +15 -8
  72. package/src/policy/permission.ts +243 -5
  73. package/src/policy/tokenizer-registry.ts +104 -0
  74. package/src/policy/usage.ts +20 -13
  75. package/src/policy/verifier.ts +7 -4
  76. package/src/policy/work-mode.ts +9 -5
  77. package/src/presentation/adapter.ts +8 -4
  78. package/src/presentation/events.ts +2 -2
  79. package/src/presentation/label.ts +3 -3
  80. package/src/presentation/model.ts +4 -0
  81. package/src/presentation/projection.ts +10 -2
  82. package/src/presentation/store.ts +2 -2
  83. package/src/providers/anthropic.ts +13 -3
  84. package/src/providers/responses.ts +16 -6
  85. package/src/runtime/capability.ts +22 -4
  86. package/src/runtime/child-execution.ts +1 -1
  87. package/src/runtime/composition.ts +5 -5
  88. package/src/runtime/execution-journal.ts +13 -7
  89. package/src/runtime/execution-registry.ts +1 -1
  90. package/src/runtime/production-execution.ts +7 -6
  91. package/src/runtime/production-runtime.ts +2 -2
  92. package/src/runtime/runtime-capabilities.ts +1 -1
  93. package/src/runtime/runtime-status-facts.ts +1 -1
  94. package/src/runtime/runtime-task-admission.ts +2 -2
  95. package/src/sandbox/os.ts +4 -3
  96. package/src/session/checkpoint.ts +29 -4
  97. package/src/session/context-assembly.ts +8 -1
  98. package/src/session/context-identity.ts +2 -2
  99. package/src/session/context-projection.ts +36 -11
  100. package/src/session/persistence.ts +22 -11
  101. package/src/task/autonomous-context.ts +2 -3
  102. package/src/task/autonomous-policy.ts +3 -3
  103. package/src/task/model.ts +2 -2
  104. package/src/task/production-scheduler.ts +2 -2
  105. package/src/task/scheduler-observability.ts +1 -0
  106. package/src/task/scheduler.ts +3 -2
  107. package/src/task/scheduling-policy.ts +2 -1
  108. package/src/task/trigger.ts +5 -5
  109. package/src/tools/git.ts +22 -4
  110. package/src/tools/lsp.ts +10 -8
  111. package/src/tools/read_image.ts +2 -1
  112. package/src/tools/task.ts +1 -1
  113. package/src/tools/web_fetch.ts +6 -2
  114. package/src/tools/web_search.ts +2 -1
  115. package/src/ui/assistant/simple.ts +42 -33
  116. package/src/ui/contract.ts +4 -0
  117. package/src/ui/footer.ts +63 -12
  118. package/src/ui/i18n/en.ts +14 -2
  119. package/src/ui/i18n/id.ts +14 -2
  120. package/src/ui/input/prompt-engine.ts +36 -10
  121. package/src/ui/render/cells.ts +320 -0
  122. package/src/ui/render/composer-wrap.ts +73 -0
  123. package/src/ui/render/detail.ts +2 -2
  124. package/src/ui/render/diff.ts +14 -5
  125. package/src/ui/render/highlight.ts +4 -4
  126. package/src/ui/render/ledger.ts +47 -0
  127. package/src/ui/render/markdown.ts +12 -5
  128. package/src/ui/render/session-summary.ts +50 -0
  129. package/src/ui/render/table-grid.ts +134 -6
  130. package/src/ui/render/theme.ts +49 -4
  131. package/src/ui/render/width.ts +91 -4
  132. package/src/ui/render/wrap.ts +5 -3
  133. package/src/ui/runtime/screen.ts +100 -22
  134. package/src/ui/runtime/statusline.ts +26 -0
  135. package/src/ui/screens/model-manager.ts +1 -1
  136. package/src/ui/session-state.ts +27 -1
  137. package/src/ui/tui/app.ts +336 -65
  138. package/src/ui/tui/transcript.ts +335 -104
  139. package/vendor/minicore/VENDOR.md +16 -12
  140. package/vendor/minicore/src/core/events.ts +1 -0
  141. package/vendor/minicore/src/core/loop.ts +11 -1
  142. package/vendor/minicore/src/core/session.ts +39 -0
@@ -1,6 +1,6 @@
1
1
  # Config & Provider
2
2
 
3
- ## 14 preset gateway
3
+ ## 15 preset gateway (termasuk Custom URL)
4
4
 
5
5
  `Gateway >` hanya menampilkan `[0] Label` tanpa URL (minimalis, tanpa bocor endpoint).
6
6
 
@@ -39,7 +39,7 @@ minicode auth logout qwen
39
39
 
40
40
  Token di `~/.minicode/auth.json` (chmod 600), bukan `config.json`. Refresh otomatis margin 60 dtk. Provider OAuth yang belum login dibuang dari daftar dengan peringatan, bukan dikirim dengan header kosong.
41
41
 
42
- > Kejujuran: device flow teruji lengkap ke server OAuth lokal (18 test: pending/slow_down/denied/expired/clamp), tapi endpoint/clientId provider belum semua terkonfirmasi live. `auth login chatgpt` fail-fast di non-TTY. Jangan baca token aplikasi desktop orang lain — itu pencurian kredensial.
42
+ > Kejujuran: device flow teruji lengkap ke server OAuth lokal (pending/slow_down/denied/expired/clamp), tapi endpoint/clientId provider belum semua terkonfirmasi live. `auth login chatgpt` fail-fast di non-TTY. Jangan baca token aplikasi desktop orang lain — itu pencurian kredensial.
43
43
 
44
44
  ## Keyring OS (ganti plaintext config)
45
45
 
@@ -58,7 +58,7 @@ Enter → pilih model (+ picker effort bila modelnya mendukung)
58
58
  Esc → batal total
59
59
  ```
60
60
 
61
- Effort tersimpan di `ProviderEntry.reasoningEffort`, berlaku sesi berikutnya, tampil badge `[low|medium|high]`. **Default universal = omit** (tanpa param thinking): default bawaan tiap model sudah di-tune vendornya. Knob hanya dikirim ke keluarga terbukti, dalam bahasa native-nya: OpenAI reasoning (`o*`, `gpt-5/6` → `reasoning_effort`, level tervalidasi per model — pro = high saja); Claude ≤4.5 → budget `1024/2048/4096`; Claude ≥4.6/5 → adaptive + `output_config.effort`. **Selain itu tak pernah dikirimi param thinking** (DeepSeek, Gemini, Groq, Ollama, free-tier, custom). Bila model menolak param (400/500), request diulang sekali tanpa param + diingat per sesi + dicatat `[thinking]` di stderr. Picker effort hanya muncul untuk model yang mendukung; sisanya select langsung tanpa menyentuh effort tersimpan. `detectAndSave`/`auth login` mempertahankan effort (tidak reset diam-diam). Mutasi ditulis ke file scope asal (bukan hasil merge) agar tidak duplikat/shadowing.
61
+ Effort tersimpan di `ProviderEntry.reasoningEffort`, berlaku sesi berikutnya, tampil badge `[low|medium|high]`. **Default universal = omit** (tanpa param thinking): default bawaan tiap model sudah di-tune vendornya. Knob hanya dikirim ke keluarga terbukti, dalam bahasa native-nya: OpenAI reasoning (`o1`/`o3`/`o4`, `gpt-5`/`gpt-6` → `reasoning_effort`, level tervalidasi per model — pro = high saja); Claude ≤4.5 → budget `1024/2048/4096`; Claude ≥4.6/5 → adaptive + `output_config.effort`. **Selain itu tak pernah dikirimi param thinking** (DeepSeek, Gemini, Groq, Ollama, free-tier, custom). Bila model menolak param (400/500), request diulang sekali tanpa param + diingat per sesi + dicatat `[thinking]` di stderr. Picker effort hanya muncul untuk model yang mendukung; sisanya select langsung tanpa menyentuh effort tersimpan. `detectAndSave`/`auth login` mempertahankan effort (tidak reset diam-diam). Mutasi ditulis ke file scope asal (bukan hasil merge) agar tidak duplikat/shadowing.
62
62
 
63
63
  Model override sekali jalan:
64
64
 
package/docs/config.md CHANGED
@@ -21,7 +21,7 @@ Di mana pengaturan dan data Minicode tinggal, dan bagaimana file lokal yang tak
21
21
  ```
22
22
 
23
23
  - `providers` — bisa juga diisi lewat wizard/`minicode config add`/`/provider`; lihat daftar preset di [Config & Provider](config-providers.md).
24
- - `providers[].contextWindows` — batas konteks dalam token per model; exact model ID menang, lalu key `"*"` menjadi fallback provider. Nilai harus integer positif. Karena gateway dapat memakai alias model, MiniCode tidak menebak kapasitas provider secara online. `--context-window` mengalahkan nilai config selama sesi itu.
24
+ - `providers[].contextWindows` — batas konteks dalam token per model; exact model ID menang, lalu key `"*"` menjadi fallback provider. Nilai harus integer positif. Karena gateway memakai alias model, MiniCode memakai **default konservatif 128K** untuk alias generik (`auto`/`best`/...) dan **32K** untuk model tak dikenal lainnya; jendela eksak tersedia lewat katalog built-in (keluarga umum), overlay `minicode pricing sync` (models.dev), dan **tokenizer presisi on-demand** dari HuggingFace untuk model open. `--context-window` mengalahkan nilai config selama sesi itu.
25
25
  - `mcpServers` — dua bentuk: stdio (`command`+`args`) dan HTTP (`url`+opsional `headers`). Detail transport di [MCP & LSP](mcp-lsp.md).
26
26
  - `verifyCommand` — dipakai `--verify` bila auto-detect tidak menemukan (urutan deteksi: `typecheck` → `test` → `tsconfig`).
27
27
  - `bashAllowlist` — pola koma/pola glob perintah bash yang dianggap aman (mode `allowlist`).
@@ -5,7 +5,7 @@ Lisensi **MIT** (lihat `LICENSE`). Kontribusi publik diterima. Praktik aktif: **
5
5
  ## Setup dev
6
6
 
7
7
  ```bash
8
- git clone https://github.com/startupmini/minicode && cd minicode
8
+ git clone https://github.com/minilabs-id/minicode && cd minicode
9
9
  bun install
10
10
  bun test # offline/hermetic; live & docker di-skip otomatis
11
11
  bun x tsc --noEmit
@@ -39,24 +39,22 @@ Coverage naik → naikkan minimum di `scripts/coverage-gate.ts` (per 2026-10-25:
39
39
 
40
40
  ```bash
41
41
  bun run gate:fast # tsc + lint + test + coverage + pack + bash + bench:smoke + audit:harness (per-commit/CI)
42
- bun run gate:slow # extreme fuzz + shadow-git stress + MCP adversarial (nightly slow.yml + manual)
43
42
  ```
44
43
 
45
- Lambat/stokastik (fuzz multi-seed, stress, docker) tinggal di `slow.yml` — kegagalannya sinyal investigasi, bukan penolakan PR. CI per-commit (`ci.yml`) hanya menjalankan yang deterministik.
44
+ Gerbang lambat/stokastik (docker sandbox) tinggal di `slow.yml` — kegagalannya sinyal investigasi, bukan penolakan PR. CI per-commit (`ci.yml`) hanya menjalankan yang deterministik.
46
45
 
47
- ### Budget ukuran paket (3.920 KiB)
46
+ ### Budget ukuran paket (3.968 KiB)
48
47
 
49
- `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.920 KiB (3,83 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
48
+ `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.968 KiB (3,875 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
50
49
 
51
- Batas 3.920 KiB disetujui pemilik pada 2026-11-05 untuk rilis v0.14.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
50
+ Batas 3.968 KiB disetujui pemilik pada 2026-11-10 untuk rilis v0.17.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
52
51
 
53
52
  Gerbang lain:
54
53
 
55
54
  ```bash
56
55
  bun run gate:bash # 62 pola serangan + 24 perintah sah → 0 bypass / 0 over-block
57
- bun run extreme # fuzz + shadow-git + MCP jahat
58
56
  bun run bench:smoke # fake, CI-safe
59
- bun run vendor:check # source MiniCore + overlay host cocok dengan vendor
57
+ bun run vendor:check # provenance MiniCore (soft; vendor host-editable sejak v0.16.0)
60
58
  ```
61
59
 
62
60
  ## Batas lapisan (dijaga `test/ui-boundary.test.ts`)
@@ -65,7 +63,7 @@ bun run vendor:check # source MiniCore + overlay host cocok dengan vendor
65
63
  - Lintas-lapisan via DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `ask`, `setupWhenEmpty`, `setSubAgentSessionFactory`. Tanpa injeksi default selalu deny / fail-closed.
66
64
  - `providers → config` satu arah (provisioning di `src/providers/provision.ts`, `src/config.ts` murni IO).
67
65
  - Layar `src/ui/screens/` = view murni (props + callback), controller di `cli/`.
68
- - Jalur non-interaktif shell-first (append-only scrollback); sesi interaktif SELALU TUI alternate-screen (kontrak I16, tanpa opsi linear).
66
+ - Jalur non-interaktif shell-first (append-only scrollback); sesi interaktif SELALU TUI alternate-screen (invariant terminal #1, tanpa opsi linear).
69
67
  - Ubah struktur/dependensi antarlapisan → wajib update `docs/architecture.md`.
70
68
 
71
69
  ## Aturan kode
@@ -21,6 +21,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
21
21
  | `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) |
22
22
  | `MINICODE_SESSION_TTL_DAYS` | TTL sesi (default 30; `0` = selamanya) |
23
23
  | `MINICODE_HOME` | Override home untuk DB lokal/global (sessions + vector); default `~` |
24
+ | `MINICODE_TOKENIZERS` | `0`/`off` → nonaktifkan unduh tokenizer presisi on-demand dari HuggingFace (fallback estimator densitas). Default: aktif untuk model open (deepseek/qwen/mistral/gemma/phi); vocab di-cache di `~/.minicode/tokenizers/`, tak diunduh ulang |
24
25
  | `MINICODE_TELEMETRY` | `0`/`false`/`off` → matikan penulisan traces.jsonl |
25
26
  | `MINICODE_VERIFY_CMD` | Custom verify command (ganti `detectVerifyCommand`) |
26
27
  | `MINICODE_ACE_ENABLED` | `0`/`false`/`off`/`no` → nonaktifkan ACE-Lite consequence engine (rollback instan ke baseline murni, tanpa self-heal loop). Default `true`. Hard-safety/tamper-guard & permission policy TETAP aktif — sakelar ini hanya mematikan evaluasi consequence, bukan batas keamanan |
@@ -33,10 +34,10 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
33
34
  | `MINICODE_LANG` | `en`/`id` → bahasa UI (prioritas lengkap di kontrak terminal §i18n: `/lang` > env ini > state.json > locale OS > en) |
34
35
  | `MINICODE_DEBUG_BUS` | `1` → cetak satu baris diagnosis event bus per turn ke stderr (`src/ui/runtime/bus-debug.ts`; diagnostik saja, bukan perilaku) |
35
36
  | `MINICODE_DEBUG_STARTUP` | `1` → cetak durasi tiap tahap setup sesi ke stderr (diagnosis startup lambat; diagnostik saja, bukan perilaku) |
36
- | `MINICODE_MINIMIZE_ANSWER` | set (nilai apa pun) → JANGAN auto-minimize section jawaban model (nilai unset = minimize default) |
37
+ | `MINICODE_MINIMIZE_ANSWER` | `1` → minimize section jawaban model (default: tidak minimize). Hanya berefek di TTY dan bila bukan `--verbose` |
37
38
  | `MINICODE_KEYSTORE_DISABLE` | `1` → matikan keystore OS seluruhnya (jatuh ke penyimpanan file; untuk CI/headless yang tak punya keychain/DPAPI) |
38
39
  | `MINICODE_KEYSTORE_FORCE_DPAPI` | `1`/`true` → paksa jalur DPAPI/Windows walau di non-Windows (khusus test portabilitas; bukan konfigurasi produksi) |
39
- | `MINICODE_MINIMIZE_TOOL` | set (nilai apa pun) → JANGAN auto-minimize section tool di TUI (nilai unset = minimize default) |
40
+ | `MINICODE_MINIMIZE_TOOL` | Di TUI section tool minimize default (setara `1`); set ke nilai selain `1` (mis. `0`) → tampilkan penuh |
40
41
 
41
42
  ## Sandbox
42
43
 
@@ -58,6 +59,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
58
59
  | `MINICODE_COMPACT_KEEP_TURNS` | Override keepRecentTurns kompaksi (bilangan ≥1; invalid → default kernel + warn) |
59
60
  | `MINICODE_MEMORY_SCOPE` | Scope baca memory: `cwd` (default) \| `global` \| `all` (gabung, tanpa silent shadowing) |
60
61
  | `MINICODE_AUTO_MEMORY` | `0` → matikan auto-simpan summary/snippet ke memory (opt-out) |
62
+ | `MINICODE_READ_VOLUME_GUARD` | `1` → aktifkan peringatan sekali per turn saat volume baca (char hasil tool) melewati ambang — penanda "banyak dibaca tanpa kompaksi" (risiko degradasi working-memory, bukan jendela token); default nonaktif |
61
63
  | `MINICODE_REPOMAP` | `regex` → paksa repo-map regex (skip LSP) |
62
64
  | `TAVILY_API_KEY` | API key untuk Tavily web_search (fallback DuckDuckGo bila kosong) |
63
65
 
@@ -75,15 +77,16 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
75
77
  |---|---|
76
78
  | `MINICODE_ASCII` | `1` → paksa glyph ASCII (`[OK]`, `>`, `.`) untuk konsol tanpa UTF-8 |
77
79
  | `MINICODE_COMPACT` | `1` → tool call ringkas, `0` → expanded. Default: compact di TUI, expanded di one-shot/exec (juga `/compact`, Ctrl+O) |
78
- | `MINICODE_JUSTIFY` | `0` → matikan rata kanan-kiri pada keluaran teks model |
80
+ | `MINICODE_JUSTIFY` | `1` → aktifkan rata kanan-kiri (justify) keluaran teks model. Default: mati (opt-in) — justify menyuntik spasi yang mengubah teks asli saat di-copy/–pipe |
79
81
  | `MINICODE_DROPDOWN` | `0` → matikan floating dropdown, pakai hint inline (konsol legacy) |
80
82
  | `MINICODE_MOUSE_SELECTION` | `0`/`false`/`off`/`no` → matikan mouse tracking TUI; default `1` untuk drag selection + wheel |
81
83
  | `MINICODE_MOTION` | `0` → matikan animasi status (pulse spark saat turn berjalan jadi glyph statis) — aksesibilitas/rekaman layar/SSH lambat |
82
84
  | `MINICODE_BELL` | `0` → matikan bell `\x07` saat approval (aksesibilitas) |
83
85
  | `MINICODE_STATUSLINE` | `rich` → statusline turn menampilkan token kumulatif + biaya sesi (default hemat) |
84
86
  | `MINICODE_A11Y` | `1` → live-region approval untuk screen reader (baris polos tanpa ANSI) |
85
- | `MINICODE_SHOW_THINKING` | `1` → tampilkan reasoning model (`--verbose` atau env) |
86
- | `MINICODE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek) |
87
+ | `MINICODE_SHOW_THINKING` | reasoning model terlihat SECARA DEFAULT; `0` → minimized (hanya penanda), `1` → paksa terlihat |
88
+ | `MINICODE_MINIMIZE_ACTIVITY` | ON secara default di TUI; `0` → transparan (baris per-tool). Lipat aktivitas tool per turn jadi satu ringkasan (detail via `/expand`) |
89
+ | `MINICORE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek). Alias lama `MINICODE_THINKING` masih dihormati |
87
90
  | `NO_COLOR` | Set apa pun selain `0` → matikan seluruh warna |
88
91
 
89
92
  ## API key fallback
@@ -20,14 +20,14 @@ npm install -g bun
20
20
  curl -fsSL https://bun.sh/install | bash
21
21
  ```
22
22
 
23
- Cek: `bun --version` harus keluar `1.4.x`. Kalau masih `command not found`, tutup-buka terminal dulu (PATH baru ke-load setelah restart).
23
+ Cek: `bun --version` harus keluar versi ≥ `1.1.13` (contoh `1.4.x`). Kalau masih `command not found`, tutup-buka terminal dulu (PATH baru ke-load setelah restart).
24
24
 
25
25
  **Langkah 2 — Pasang Minicode:**
26
26
 
27
27
  ```bash
28
28
  npm install -g minicode-ai
29
29
  # bin: minicode
30
- minicode --version # harus 0.11.x
30
+ minicode --version # pastikan versi terbaru terpasang
31
31
  ```
32
32
 
33
33
  Kenapa butuh keduanya? `npm` = toko distribusi, `Bun` = mesin yang menjalankan. Tanpa Bun, `minicode` gagal dengan `'bun' is not recognized`.
@@ -35,7 +35,7 @@ Kenapa butuh keduanya? `npm` = toko distribusi, `Bun` = mesin yang menjalankan.
35
35
  Untuk kontributor (kerja dari source):
36
36
 
37
37
  ```bash
38
- git clone https://github.com/startupmini/minicode && cd minicode
38
+ git clone https://github.com/minilabs-id/minicode && cd minicode
39
39
  bun install && bun link
40
40
  ```
41
41
 
@@ -56,7 +56,7 @@ Setup wizard berjalan otomatis saat `minicode` pertama kali bila belum ada provi
56
56
  |---|---|---|---|
57
57
  | Linux + bubblewrap | Ya, tanpa flag | `auto` | Paling terisolasi untuk `bash` |
58
58
  | macOS + seatbelt | Ya, tanpa flag | `auto` | Sama, via seatbelt |
59
- | Windows (semua) / tanpa bwrap-seatbelt | Tidak tersedia | Turun ke `allowlist` + alasan dicetak sekali | Lebih baik membatasi perintah daripada label aman palsu. Pilih sendiri dengan `--allow-all` / `--ask`, matikan dengan `--sandbox none`, atau pakai `--sandbox docker` |
59
+ | Windows (semua) / tanpa bwrap-seatbelt | Tidak tersedia | `auto` (bash `restrictBash` allow-list otomatis) | Lebih baik membatasi perintah daripada label aman palsu. Pilih sendiri dengan `--allow-all` / `--ask`, matikan dengan `--sandbox none`, atau pakai `--sandbox docker` |
60
60
 
61
61
  Docker **tidak** dipakai otomatis meski tersedia — menarik image tanpa diminta terlalu invasif untuk default.
62
62
 
@@ -82,7 +82,7 @@ One-shot, `exec`, pipe, dan CI hanya menampilkan notifikasi (tanpa install).
82
82
  ```bash
83
83
  npm install -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
84
84
  minicode sync # refresh model baru dari semua provider
85
- minicode pricing sync # refresh cache harga (3.162 model, ~213 KB)
85
+ minicode pricing sync # refresh cache harga dari models.dev
86
86
  ```
87
87
 
88
88
  Opt-out: `NO_UPDATE_CHECK=1` atau `MINICODE_AUTO_UPDATE=0`.
package/docs/mcp-lsp.md CHANGED
@@ -26,9 +26,9 @@ Setelah terdaftar, `mcp_list` menampilkan **tools, resources, prompts** sekaligu
26
26
 
27
27
  Tool dinamis `serverId.toolName` otomatis muncul. `resources`/`prompts` opsional di spec: server "Method not found" tetap terhubung dengan tool utuh.
28
28
 
29
- Keamanan HTTP: host privat ditolak kecuali `--allow-private` (penjaga sama dengan `web_fetch`: DNS pinning). Redirect tidak diikuti. Ukuran dibatasi. Balasan dicocokkan per request id. Header `Authorization` tidak masuk log.
29
+ Keamanan HTTP: host privat ditolak kecuali `--allow-private` (penjaga sama dengan `web_fetch`: resolve DNS tanpa cache + tolak host privat). Redirect tidak diikuti. Ukuran dibatasi. Balasan dicocokkan per request id. Header `Authorization` tidak masuk log.
30
30
 
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).
31
+ Izin: semua MCP bertitik selalu di-gate. Di `ASK`, pemanggilan minta konfirmasi sekali per pasangan server+tool+args (`[a] Always` persist ke allowlist); di `AUTO`, tool yang terdaftar/diotorisasi jalan tanpa prompt sedangkan yang tak dikenal di-*deny* (bukan di-prompt). `readonly`/`plan`/`allowlist` menolak. Tanpa wildcard auto-allow (proteksi supply-chain).
32
32
 
33
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
 
@@ -56,13 +56,13 @@ Jurnal bukan transaksi atomik; `pending` = ambigu (efek mungkin sudah terjadi).
56
56
 
57
57
  Model hanya melihat jendela riwayat terbatas (**konteks**). Saat percakapan menekan jendela itu, Minicode **memadatkan** (compaction): turn lama diganti satu ringkasan, turn terbaru dipertahankan utuh. Anda melihatnya sebagai baris `── compacted: …` di output.
58
58
 
59
- Batas konteks dibaca per model dari `providers[].contextWindows` (exact model ID, lalu `"*"`); `--context-window` mengalahkan config untuk sesi itu. Bila metadata tidak ada, fallback 32.000 token diberi peringatan. Saat model berganti, admission dan pemutus stream mengikuti batas model baru. Estimator juga dikalibrasi per provider/model setelah usage aktual; CJK dan emoji tidak lagi dihitung sebagai teks biasa `chars/4`.
59
+ Batas konteks dibaca per model dari `providers[].contextWindows` (exact model ID, lalu `"*"`); `--context-window` mengalahkan config untuk sesi itu. Bila metadata tidak ada, model tak dikenal diberi fallback 32.000 token (diberi peringatan), alias router (`auto`/`best`/...) mendapat default konservatif 128K supaya kompaksi tak prematur. Estimator kini **sadar densitas** — kode/JSON dihitung ~2.4 chars/token dan CJK/emoji ~1 — serta dikalibrasi per provider/model setelah usage aktual; model open (deepseek/qwen/mistral/gemma/phi) bisa memakai **tokenizer presisi on-demand** dari HuggingFace.
60
60
 
61
61
  - **Kapan terjadi:** otomatis saat tekanan konteks, sebelum request dikirim. Resume membatasi proyeksi dan histori; kernel menghitung prompt sistem serta skema tool sebelum admission. Output model dihentikan saat anggaran tersisa habis. Bila current prompt/instruksi sendiri tak muat, run gagal dengan alasan dan langkah lanjut.
62
62
  - **Yang dipertahankan:** ringkasan fakta — path file, signature, snippet penting, hasil tool, error, next steps. Ringkasan lama dan baru dibatasi ukuran; jika summary projection terlalu besar, bagian lama dipotong eksplisit atau selector memilih ekor histori yang muat.
63
- - **Yang mungkin hilang:** teks lengkap turn lama (dipotong ~250 char/baris saat diringkas), detail output tool, urutan persis percakapan.
63
+ - **Yang mungkin hilang:** teks lengkap turn lama (prosa dipotong ~250 char/baris; hasil tool **pembawa fakta** — grep/bash/read/test/fetch — dipertahankan lebih panjang, ~800 char/baris), detail output tool yang melebihi batas head itu, urutan persis percakapan.
64
64
  - **Riwayat asli tidak disimpan ganda:** sesi berjalan dan sesi tersimpan mengikuti state terbaru (ringkasan + turn baru). Yang perlu durable lintas sesi, tulis eksplisit via `write_memory`.
65
- - **Ringkasan lebih cerdas bila ada kunci DeepSeek** (`DEEPSEEK_API_KEY`): ringkasan dibuat LLM (timeout 10 dtk); tanpanya dipakai ringkasan mekanikal. Keduanya memagar konten tak-terpercaya sebagai data + secret-scrub sebelum diringkas.
65
+ - **Ringkasan lebih cerdas bila ada kunci DeepSeek** (`DEEPSEEK_API_KEY`) **atau provider sesi**: ringkasan dibuat LLM (timeout 10 dtk) — pakai summarizer murah DeepSeek bila kuncinya ada, jika tidak pakai ulang router/provider sesi; tanpa keduanya dipakai ringkasan mekanikal. Keduanya memagar konten tak-terpercaya sebagai data + secret-scrub sebelum diringkas.
66
66
  - **Beda dengan memory:** ringkasan konteks hidup di sesi berjalan; `write_memory`/vector hidup lintas sesi dan bisa di-retrieval. Ringkasan juga disimpan sebagai memori kategori `summary` — matikan via `MINICODE_AUTO_MEMORY=0` bila tak diinginkan.
67
67
 
68
68
  ## Repo intelligence & telemetry
@@ -39,13 +39,16 @@ Set terkait: `INTERNAL_WRITE_TOOLS`, `FILE_WRITE_TOOLS`, `GATED_TOOLS` (+ `*.*`
39
39
  | `type %USERPROFILE%\notes.txt` | ditolak; argumen pembaca berpola `%NAMA%` tak bisa dipastikan aman |
40
40
  | `for /f %i in (.env) do @echo %i` | ditolak; file set pada loop `for /f` ikut diperiksa |
41
41
 
42
- Allowlist (juga default bila tanpa sandbox): `git status/diff/log/branch/show`, `bun test/run/x tsc`, `npm run/exec`, `npx`, `ls cat head tail wc grep rg find which echo pwd`. Tulis via shell (`mkdir cp mv rm touch`) ditahan — pakai `write_file`/`edit` yang ter-jail. `npm exec`/`npx`/`bun run`/`bun x` tak boleh ada ekspansi shell (`$`, backtick) atau redirection.
42
+ Allowlist (bentuk perintah yang boleh; diperiksa SETELAH bash-guard). Dua daftar:
43
+ - **Narrow** (`--allowlist`, task tak-terpercaya): `git status/diff/log/branch/show`, `bun test/run/x tsc`, `npm/bun/pnpm/yarn install|add`, `npm run/exec/install/ci/test/start`, `node`, `npx`, `ls dir cat type head tail wc grep rg find which echo pwd`. Tulis via shell (`mkdir cp mv rm touch`) ditahan — pakai `write_file`/`edit` yang ter-jail.
44
+ - **Developer** (fallback tanpa sandbox OS — `restrictBash`; sesi trusted di mesin sendiri): narrow + runtime/interpreter luas (`python`/`node`/`ruby`/`php`/`perl`/`lua`/`julia`/`elixir`/`groovy`/`scala`/`java`/`dotnet`/`swift`/`dart`…), package manager (`pip`/`pip3`/`uv`/`pipx`/`poetry`/`pipenv`/`gem`/`bundle`/`composer`/`cargo`/`go`/`nuget`…), framework/bundler (`vite`/`next`/`nuxt`/`webpack`/`esbuild`/`rollup`…), test/lint/build (`pytest`/`ruff`/`mypy`/`jest`/`vitest`/`eslint`/`tsc`/`mvn`/`gradle`/`dotnet`/`make`/`cmake`/`gcc`…), DB CLI (`psql`/`mysql`/`sqlite3`/`prisma`…), container (`docker`/`podman`).
45
+
46
+ `npm exec`/`npx`/`bun run`/`bun x` tak boleh ekspansi shell (`$`, backtick) atau redirection. Runtime hanya menjalankan berkas skrip — eval inline (`-e`/`--eval`/`-c`/`-r`/`--require`) difilter guard lebih dulu untuk SEMUA interpreter (termasuk baru: `lua -e`, `julia -e`, …). **Verba rilis-registry** (`npm publish`, `cargo publish`/`login`, `gem push`, `docker push`, `mvn deploy`, `dart pub publish`, `twine upload`…) ditolak guard di SEMUA mode. Package manager menjalankan lifecycle script (postinstall/setup.py = kode arbitrer dari registry), jadi kedua daftar berstatus "trusted", bukan pengganti isolasi — isolasi sungguhan tetap `--sandbox docker`.
43
47
 
44
48
  Ukur, bukan klaim — jalankan sendiri untuk angka terkini:
45
49
 
46
50
  ```bash
47
51
  bun run gate:bash # korpus manual pola serangan + perintah sah (0 bypass / 0 over-block = lulus)
48
- bun run extreme:fuzz # mutasi kombinatorial ber-seed
49
52
  ```
50
53
 
51
54
  Fuzz membangkitkan varian dari transformasi yang shell anggap setara (quote-split, indirection, wrapper, flag panjang, chaining); temuan terkunci sebagai regression test.
@@ -57,7 +60,7 @@ Fuzz membangkitkan varian dari transformasi yang shell anggap setara (quote-spli
57
60
  | Kondisi | Yang terjadi |
58
61
  |---|---|
59
62
  | bwrap (Linux) / seatbelt (macOS) tersedia | Bash di dalamnya, tanpa flag |
60
- | Tidak tersedia (termasuk semua Windows) | Default turun ke `allowlist` + alasan dicetak sekali |
63
+ | Tidak tersedia (termasuk semua Windows) | Default turun ke restrictBash (allowlist **developer**, sesi trusted); tanpa pesan `[sandbox]` — pesan itu hanya muncul untuk request `--sandbox` eksplisit |
61
64
  | `--allow-all` / `--ask` / `--plan` / `--allowlist` diberikan | Pilihan dihormati, tanpa peringatan |
62
65
  | `--sandbox none` | Opt-out sadar; tanpa downgrade |
63
66
  | `--sandbox docker` | Container ephemeral (`--network none`, 512m, 1 CPU, `node:22-alpine`) |
@@ -75,6 +78,6 @@ workspace yang sudah terjadi sebelum container dihentikan.
75
78
 
76
79
  - **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.
77
80
  - **Env scrub** `sanitizeSpawnEnv`: strip kata-kunci kredensial dari merge final; `GITHUB_WORKSPACE`/`GITHUB_REF`/`GOOGLE_CHROME_PATH`/`REDIS_HOST`/`AWS_REGION` tetap ada, `GITHUB_TOKEN`/`AWS_SECRET_ACCESS_KEY`/`DATABASE_URL` tetap di-strip.
78
- - **web_fetch/web_search**: redirect manual 5 hop + DNS pinning 30 dtk + body 2 MB.
81
+ - **web_fetch/web_search**: redirect manual 5 hop + resolve DNS tanpa cache per hop (anti-rebinding) + body 2 MB.
79
82
  - **Secret scrubber**: `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` di-redact sebelum ke LLM (read_file/bash/grep) — tanpa whitelist kata.
80
83
  - **Config/allowlist**: atomic randomUUID tmp+rename + chmod 600. MCP serve curated tools + permission aktif.
@@ -6,8 +6,8 @@
6
6
  25 harga bawaan tersedia offline. Untuk cakupan luas, tarik sendiri — **tidak ada fetch otomatis** di jalur run (jalur run hanya baca cache lokal agar tidak menambah latensi/bocor pola pemakaian):
7
7
 
8
8
  ```bash
9
- minicode pricing sync # 3.162 model dari models.dev (~213 KB cache)
10
- minicode pricing status # sumber aktif + umur cache + tanda (stale) >30 hari
9
+ minicode pricing sync # tarik katalog + harga dari models.dev
10
+ minicode pricing status # sumber aktif + umur cache + tanda (stale) bila cache lebih tua dari 1 hari
11
11
  minicode pricing show claude-sonnet-4-5
12
12
  minicode pricing clear # kembali ke bawaan
13
13
  ```
@@ -27,7 +27,7 @@ minicode --budget 0.05 --budget-strict "task ketat"
27
27
 
28
28
  - Peringatan kuning 80%.
29
29
  - Lewat budget: one-shot `exit(1)`, TUI `break` loop, `exec` menegakkan sama seperti one-shot (pernah ada bug `exec` mengabaikan `--budget`, sudah diperbaiki).
30
- - Pagu juga diputus MID-TURN: watcher biaya live (`watchBudgetLimit` di `cli/setup.ts`) menggugurkan turn yang sedang berjalan begitu lewat — dulu tool loop / siklus self-heal bisa belanja tanpa batas dalam satu turn. Abort budget membawa identitas kind `budget_exceeded` (bukan `aborted` generik) agar terbedakan dari Ctrl+C user.
30
+ - Pagu juga diputus MID-TURN: watcher biaya live (`watchBudgetLimit` di `src/policy/usage.ts`, dipasang di `cli/setup.ts`) menggugurkan turn yang sedang berjalan begitu lewat — dulu tool loop / siklus self-heal bisa belanja tanpa batas dalam satu turn. Abort budget membawa identitas kind `budget_exceeded` (bukan `aborted` generik) agar terbedakan dari Ctrl+C user.
31
31
  - Cost tak dikenal (model tanpa harga) + ADA pemakaian = fail-closed secara DEFAULT: dianggap over budget, bukan diabaikan (dulu hanya di `--budget-strict`; perilaku lama membuat `--budget` diam-diam mati untuk model baru). Nol token (belum belanja, mis. pre-check prompt baru) tetap lolos.
32
32
  - `--budget-strict` / `MINICODE_BUDGET_STRICT=1` = penegasan eksplisit perilaku fail-closed di atas (back-compat; perilaku sama dengan default).
33
33
  - Harga negatif/NaN/Infinity dari overlay lokal ditolak saat ekstraksi (bukan biaya negatif yang mengurangi total).
@@ -23,7 +23,7 @@ minicode auth status # lihat kredensial + kapan kedaluwarsa
23
23
  minicode --work-mode BUILD "buat http server hello world di server.ts" --verbose
24
24
  ```
25
25
 
26
- Yang terjadi: model menerima system prompt berisi `# Environment` (cwd + platform) + repo-map ringkas, lalu loop ReAct `Thought → Action → Observation` sampai jawaban final atau batas (`--max-steps` default 50, `--timeout` default 15 menit).
26
+ Yang terjadi: model menerima system prompt berisi `# Environment` (cwd + platform) + repo-map ringkas, lalu loop ReAct `Thought → Action → Observation` sampai jawaban final atau batas (`--max-steps` default 50, `--timeout` default 1 jam).
27
27
 
28
28
  Coba mode interaktif:
29
29
 
package/docs/repl.md CHANGED
@@ -1,20 +1,21 @@
1
1
  # TUI — Slash & Keyboard (satu tampilan fullscreen)
2
2
 
3
- Ketik `/` di prompt → dropdown berbingkai (max 8 + `… N more`). `↑`/`↓`
3
+ Ketik `/` di prompt → dropdown polos (tanpa bingkai; `max 8` baris, daftar panjang dipotong tanpa baris `… N more` — baris itu hanya ada di `askLine`/dialog linear). `↑`/`↓`
4
4
  navigasi, `Enter` lengkapi + submit, `Esc` tutup. Semua permukaan interaktif
5
5
  hidup di dalam TUI fullscreen; terminal tanpa ANSI/alt-screen = pesan satu
6
6
  baris + keluar (interaktif butuh TTY ≥10 baris).
7
7
 
8
- Bahasa UI: `MINICODE_LANG=en|id` > `/lang` (disimpan state.json) > locale OS >
9
- en. `/lang` tanpa argumen = tampilkan aktif. Semua string lewat kamus i18n
8
+ Bahasa UI: `/lang` (sesi, tersimpan state.json) > `MINICODE_LANG` > state.json `lang` >
9
+ locale OS > en. `/lang` tanpa argumen = tampilkan aktif. Semua string lewat kamus i18n
10
10
  (`src/ui/i18n/`); literal Indonesia hardcode di luar kamus dilarang test.
11
11
 
12
12
  ## Slash commands
13
13
 
14
14
  | Command | Fungsi |
15
15
  |---|---|
16
- | `/help` | Daftar perintah + tombol penting |
17
- | `/help tombol` | Pintasan papan tombol lengkap |
16
+ | `/help` | Daftar perintah ringkas, terkelompok per kategori (Session/Model/Mode/View/Task) |
17
+ | `/help full` | Daftar lengkap terkelompok dengan deskripsi (alias `/help all`); `/help` kosong dari non-TTY juga menampilkan ini |
18
+ | `/help keys` | Pintasan papan tombol lengkap (alias `/help tombol`) |
18
19
  | `/provider` | Kelola provider: popup — picker preset + form (URL/key/scope/timpa), hapus (`d`, menyebut jumlah model yang ikut hilang), ubah (`e`) |
19
20
  | `/model [cari]` | Popup semua `provider::model` (argumen = filter awal; di dalam ketik langsung cari live, Ctrl+U clear, Esc keluar filter). Del = hapus (konfirmasi). Enter = pilih + atur thinking effort (`default/low/medium/high`, tersimpan di provider, berlaku sesi berikutnya; Esc = batal total). Effort non-default tampil badge `[low|medium|high]` |
20
21
  | `/sync` | Segarkan daftar model semua provider (hanya bilang restart bila benar ada model baru) |
@@ -30,11 +31,13 @@ en. `/lang` tanpa argumen = tampilkan aktif. Semua string lewat kamus i18n
30
31
  | `/clear` | Kosongkan transkrip (viewport kembali kosong) |
31
32
  | `/expand` | Buka isi tool/thinking yang disembunyikan ledger compact (sekali ambil habis) |
32
33
  | `/history` | 20 entri prompt terakhir |
33
- | `/exit` | Keluar (satu-satunya jalan keluar; `/quit` alias) |
34
+ | `/exit` | Keluar (satu-satunya jalan keluar; `/quit` alias). Setelah keluar, tercetak kop ringkasan sesi: wordmark `minicode` + Session/Model/Usage (token, biaya, durasi) |
34
35
  | `/scheduler [status\|run\|stop]` | Kendali Scheduler produksi. **Nonaktif secara bawaan** di setiap sesi (perlu flag `--enable-scheduler`); tanpa flag, perintahnya menjawab "not enabled". Tetap tampil di `/help` supaya operator yang mengaktifkan flag bisa menemukannya. |
35
36
 
36
37
  Alias (jalan, tidak diiklankan di `/help`): `/models` → `/model`, `/providers` → `/provider`, `/usage` & `/cost` → `/status`, `/resume [id]` → `/sessions [id]`, `/compact`, `/thinking`, `/minimize`, `/quit`.
37
38
 
39
+ Perintah tersembunyi (sengaja tak tampil di `/help`/dropdown, per-sesi): `/unrestric` — full akses tanpa jail/bash-guard/sandbox, gerbang = kepercayaan operator (toggle; indikator gembok terbuka 🔓 di footer). Detail di [Security Model](security-model.md).
40
+
38
41
  Did-you-mean: typo `/sessoons` → `Did you mean /sessions?` (jarak ≤ 2).
39
42
 
40
43
  ## Keyboard
@@ -59,8 +62,8 @@ Did-you-mean: typo `/sessoons` → `Did you mean /sessions?` (jarak ≤ 2).
59
62
  | `ctrl+o` | Putar tool call compact/expanded (juga `/compact`) |
60
63
  | `ctrl+t` | Toggle tampilan thinking expanded/minimized (juga `/thinking`) |
61
64
  | `esc` | Tutup dropdown/picker; dua-tahap di form (tekan-1 bersihkan field, tekan-2 batal); busy = batalkan turn |
62
- | `ctrl+c` | Batalkan input/prompt; pada turn TUI gunakan `Esc` untuk abort |
63
- | `ctrl+d` | Keluar saat baris kosong; busy = abaikan |
65
+ | `ctrl+c` | Salin selection (TUI); tanpa selection = no-op. Abort turn pakai `Esc` (`Esc` dua kali dalam 1,5 dtk, atau `Ctrl+D` baris-kosong, saat abort macet) |
66
+ | `ctrl+d` | Keluar saat baris kosong; saat busy baris-kosong = abort turn lalu keluar |
64
67
 
65
68
  ## Aturan konsistensi (kontrak I25)
66
69
 
@@ -17,7 +17,7 @@ Permission → Jail → Bash Guard → Argument Validation → Executor → Jour
17
17
  | Tahap | Fungsi |
18
18
  |---|---|
19
19
  | **Permission** | Mode izin (`src/policy/permission.ts`) memutuskan allow/deny/ask per pasangan tool+args. Berlaku SEBELUM efek apa pun. |
20
- | **Jail** | Path di luar workspace, symlink keluar, file sensitif (`.env`, `.git/config`), dan state milik minicode (`.minicode/*.db`, todos, jurnal, config) ditolak — **bahkan di `--allow-all`**. |
20
+ | **Jail** | Path di luar workspace, symlink keluar, file sensitif (`.env`, `.git/config`), dan state milik minicode (`.minicode/*.db`, todos, jurnal, config) ditolak — **bahkan di `--allow-all`** (kecuali mode `unrestricted`, lihat §Mode dan akses di bawah). |
21
21
  | **Bash Guard** | Perintah shell dinormalisasi dulu (buang quote/wrapper/variabel sederhana), baru diperiksa polanya. Menolak env-dump, exfiltrasi upload, interpreter inline, destruksi luas. |
22
22
  | **Argument Validation** | Skema argumen divalidasi kernel sebelum eksekusi; argumen invalid ditolak tanpa efek. |
23
23
  | **Executor** | Menjalankan yang lolos: read paralel, write dibatasi konkurensinya, abort-aware, output dipotong dengan penanda (tak pernah diam-diam). |
@@ -35,6 +35,8 @@ Pilihan yang terlihat oleh operator dipisah menjadi tiga sumbu:
35
35
 
36
36
  **Profil `allow-all` tetap terbatas.** Path jail, penolakan state milik runtime, bash-guard, dan validasi argumen tetap berlaku; profil ini tidak memberi akses host tanpa batas. Detail implementasi dan opsi CLI ada di [Policy & Sandbox](policy-sandbox.md).
37
37
 
38
+ **Pengecualian eksplisit: `unrestricted`.** Satu-satunya mode yang melepas seluruh lapisan di atas — tanpa path jail, tanpa bash-guard, tanpa sandbox/allowlist. Diaktifkan eksplisit oleh operator lewat perintah TUI tersembunyi `/unrestric` (bukan flag CLI, sengaja tak muncul di `/help` maupun daftar `/`), berlaku **per-sesi saja** dan tak pernah persist. Gerbang keamanannya adalah kepercayaan operator kepada model — blast radius penuh (file apa pun di host, shell apa pun). Default tetap `DISCUSS`+`AUTO` dengan hard-deny aktif.
39
+
38
40
  ## Trust Boundaries
39
41
 
40
42
  | Sumber | Status | Artinya |
@@ -85,7 +87,7 @@ Kejujuran yang disengaja: crash ambiguity TETAP MUNGKIN (filesystem dan database
85
87
 
86
88
  ## Security Contact
87
89
 
88
- Belum ada kontak keamanan privat. Laporkan masalah via [GitHub Issues](https://github.com/startupmini/minicode/issues) **tanpa menyertakan kredensial, token, atau data sensitif** — cukup langkah reproduksi minimal + output `minicode doctor`.
90
+ Belum ada kontak keamanan privat. Laporkan masalah via [GitHub Issues](https://github.com/minilabs-id/minicode/issues) **tanpa menyertakan kredensial, token, atau data sensitif** — cukup langkah reproduksi minimal + output `minicode doctor`.
89
91
 
90
92
  ## Lanjut
91
93
 
package/docs/security.md CHANGED
@@ -2,8 +2,8 @@
2
2
 
3
3
  ## Prinsip
4
4
 
5
- 1. **Fail-closed di jalur tak pasti**: tool tanpa backend tersedia menolak (`code_run`), sandbox yang diminta tapi tidak tersedia tidak pura-pura aman (warn + `allowlist`), provider OAuth yang belum login dibuang dari daftar, auth non-TTY fail-fast.
6
- 2. **Ukur, bukan klaim**: bash-guard divalidasi korpus manual pola serangan + perintah sah dan fuzz kombinatorial ber-seed — jalankan `bun run gate:bash` dan `bun run extreme:fuzz` untuk angka terkini (exit 0 = 0 bypass / 0 over-block).
5
+ 1. **Fail-closed di jalur tak pasti**: tool tanpa backend tersedia menolak (`code_run`), sandbox yang diminta tapi tidak tersedia ditolak (fail-closed; fallback host hanya via `MINICODE_SANDBOX_ALLOW_FALLBACK=1`), provider OAuth yang belum login dibuang dari daftar, auth non-TTY fail-fast.
6
+ 2. **Ukur, bukan klaim**: bash-guard divalidasi korpus manual pola serangan + perintah sah — jalankan `bun run gate:bash` untuk angka terkini (exit 0 = 0 bypass / 0 over-block).
7
7
  3. **Teks eksternal = tidak terpercaya**: output tool, MCP, web, bahkan output verify dibungkus fence; `sanitizeAnsi` menyaring escape ANSI dari teks model/tool sebelum render.
8
8
  4. **Permission mengontrol pemanggilan, bukan capability**: di ASK, satu approval hanya mencakup pasangan server+tool+args (MCP); capability di balik server tak bisa diketahui statis.
9
9
 
@@ -13,12 +13,12 @@ Kontrol mode punya tiga sumbu: **WorkMode** (`DISCUSS`/`PLAN`/`BUILD`) membatasi
13
13
 
14
14
  ## Lapisan perlindungan bash
15
15
 
16
- 1. **Bash-guard ternormalisasi** (`src/policy/bash-guard.ts`) menormalisasi command sebelum aturan diterapkan. Tabel bypass termasuk redirect, ekspansi env Windows, hardlink, escape caret, dan pembaca `for /f` ada di [Policy & Sandbox](policy-sandbox.md), satu sumber contoh. `bun run gate:bash` dan `bun run extreme:fuzz` mengukur regresi.
16
+ 1. **Bash-guard ternormalisasi** (`src/policy/bash-guard.ts`) menormalisasi command sebelum aturan diterapkan. Tabel bypass termasuk redirect, ekspansi env Windows, hardlink, escape caret, dan pembaca `for /f` ada di [Policy & Sandbox](policy-sandbox.md), satu sumber contoh. `bun run gate:bash` mengukur regresi.
17
17
 
18
- 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).
18
+ 2. **Allowlist** — bentuk perintah yang boleh; diperiksa SETELAH bash-guard. Dua daftar: **narrow** (`--allowlist`, task tak-terpercaya): `git status/diff/log/branch/show`, `bun test/run/x tsc`, `npm/bun/pnpm/yarn install|add`, `npm run/exec/install/ci/test/start`, `node`, `npx`, `ls dir cat type head tail wc grep rg find which echo pwd` — tulis via shell ditahan (pakai `write_file`/`edit`). **Developer** (fallback tanpa sandbox OS, `restrictBash` — sesi trusted di mesin sendiri): narrow + runtime/interpreter luas (`python`/`node`/`ruby`/`php`/`perl`/`lua`/`julia`/`elixir`/`groovy`/`scala`/`java`/`dotnet`/`swift`/`dart`…), package manager (`pip`/`uv`/`poetry`/`pipenv`/`composer`/`gem`/`bundle`/`cargo`/`go`/`nuget`…), framework/bundler (`vite`/`next`/`nuxt`/`webpack`/`esbuild`/`rollup`…), test/lint/build (`pytest`/`ruff`/`mypy`/`jest`/`vitest`/`eslint`/`tsc`/`mvn`/`gradle`/`dotnet`/`make`/`cmake`/`gcc`…), DB CLI (`psql`/`mysql`/`sqlite3`/`prisma`…), container (`docker`/`podman`). `npm exec`/`npx`/`bun run`/`bun x` tak boleh ekspansi shell/redirection. Runtime hanya menjalankan berkas skrip — **eval inline** (`-e`/`--eval`/`-c`/`-r`/`--require`) ditolak guard untuk SEMUA interpreter, termasuk yang baru (`lua -e`, `julia -e`, `elixir -e`, …). **Verba rilis-registry** (`npm publish`, `cargo publish`/`login`, `gem push`, `dotnet nuget push`, `docker push`/`login`, `mvn deploy`, `gradle publish`, `dart pub publish`, `twine upload`…) ditolak guard di SEMUA mode (aksi ireversibel butuh kredensial) — sehingga daftar developer boleh luas tanpa membuka jalur terbit diam-diam. Package manager menjalankan lifecycle script (postinstall/setup.py = kode arbitrer dari registry), jadi keduanya "trusted project", bukan pengganti isolasi — isolasi sungguhan tetap `--sandbox docker`. `git --no-index/--exec-path/--upload-pack/--receive-pack`, transport `ext::`, dan `GIT_EXTERNAL_DIFF`/`GIT_CONFIG_*` inline ditolak guard (git sebagai pelarian jail).
19
19
  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`.
20
20
  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.
21
- 5. **web_fetch/web_search**: redirect manual ≤5 hop + DNS pinning 30 dtk + body cap 2 MB. Host privat ditolak (sama untuk MCP HTTP).
21
+ 5. **web_fetch/web_search**: redirect manual ≤5 hop + resolve DNS tanpa cache per hop (anti-rebinding) + body cap 2 MB. Host privat ditolak (sama untuk MCP HTTP).
22
22
 
23
23
  `grep` memakai ripgrep bila tersedia. Biner di-resolve dari PATH absolut yang
24
24
  tepercaya, environment child disanitasi, dan config eksternal dinonaktifkan
@@ -31,7 +31,7 @@ tidak mewarisi konfigurasi tersebut.
31
31
  - Output verify dibungkus fence agar instruksi di error build tidak diikuti model.
32
32
  - `mcp_read`/`mcp_prompt` di-gate meski read-only — konten pihak ketiga langsung ke konteks = jalur injection; "read-only ≠ aman".
33
33
  - Secret scrubber meredaksi `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` sebelum teks ke LLM (read_file/bash/grep), tanpa whitelist kata.
34
- - Bypass korpus + fuzz: `bun run gate:bash`, `bun run extreme:fuzz` (`--seed` untuk reproduksi). Batas jujur: analisis statis atas bahasa Turing-complete; `$(curl …)` dinamis perlu sandbox OS/docker.
34
+ - Bypass korpus: `bun run gate:bash`. Batas jujur: analisis statis atas bahasa Turing-complete; `$(curl …)` dinamis perlu sandbox OS/docker.
35
35
 
36
36
  ## Batas kepercayaan file lokal (trust model)
37
37
 
@@ -53,8 +53,9 @@ provider model pihak ketiga.
53
53
  - State milik runtime (`.minicode/` — DB, todos, plans, checkpoints, jurnal,
54
54
  traces, allowlist, config, + file APAPUN lain di bawahnya): tulis via file
55
55
  tools ditolak fail-closed (pengecualian: restore `.minicode/.trash/` →
56
- workspace dan skrip hooks `.minicode/hooks/` — eksekusi hook tetap butuh
57
- registrasi allowlist yang terkunci); baca tetap boleh (observability). Tulis
56
+ workspace dan skrip hooks `.minicode/hooks/` — hook adalah kode arbitrer di
57
+ luar permission system, aktif hanya via opt-in `MINICODE_HOOKS=1` dan
58
+ dilarang di WorkMode non-`EXECUTE`); baca tetap boleh (observability). Tulis
58
59
  catatan sendiri ke workspace, bukan ke `.minicode/`.
59
60
 
60
61
  ## Config lokal & supply chain
package/docs/skills.md CHANGED
@@ -22,7 +22,7 @@ Review this diff: {{args}}
22
22
  Perilaku penting:
23
23
 
24
24
  - Skill **bukan tool** — ia memanjangkan prompt pertama, jadi tetap tunduk pada permission mode yang sama.
25
- - Tab di dropdown hanya menawarkan perintah builtin + `/compact`; skill tetap bisa diketik manual dan ter-lookup grouped saat keduanya match.
25
+ - Dropdown `/` menawarkan perintah builtin, driver command (`/compact`/`/thinking`/`/expand`/…), dan skill terpasang. `Tab` BUKAN autocomplete — ia memutar WorkMode (`Shift+Tab` memutar PermissionMode).
26
26
 
27
27
  ## AGENTS.md: instruksi proyek
28
28
 
@@ -39,7 +39,7 @@ Hooks mati secara default; nyalakan dengan `MINICODE_HOOKS=1`.
39
39
  | Konteks | Env `MINICODE_HOOK_CTX` (JSON run) |
40
40
  | Sanitasi | Env hook disanitasi tanpa secret; hook dilewati bila sesi dibatalkan |
41
41
 
42
- Hooks global + lokal di-merge dari allowlist secara atomik (chmod 600). Karena hook adalah kode arbitrer, hanya allowlist yang terdaftar yang jalan — repo clone-an tidak bisa menyuntik hook sendiri tanpa Anda percayai (sama dengan aturan config lokal; lihat [Keamanan](security.md)).
42
+ Hooks global + lokal di-merge (bukan lewat allowlist). Karena hook adalah kode arbitrer di luar permission system, ia hanya jalan bila `MINICODE_HOOKS=1` dan WorkMode `EXECUTE` (tidak di `DISCUSS`/`PLAN`); setiap hook dikenai timeout 5 dtk dan env-nya disanitasi. Repo clone-an bisa menyuntik `.minicode/hooks/*.js` — perlakukan seperti config lokal yang tak tepercaya (lihat [Keamanan](security.md)).
43
43
 
44
44
  ## Lanjut
45
45
 
package/docs/terminal.md CHANGED
@@ -28,7 +28,7 @@ bisa di-pipe, di-grep, dan tinggal di scrollback Anda sendiri.
28
28
  | stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY — ditahan saat layar interaktif memegang terminal |
29
29
 
30
30
  - Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe.
31
- - Error `✗ pesan actionable` sekali per kegagalan (`takePendingError`) — bukan spam di setiap langkah.
31
+ - Error `pesan actionable` (berwarna merah, tanpa ikon sejak v0.17.0) sekali per kegagalan (`takePendingError`) — bukan spam di setiap langkah.
32
32
 
33
33
  ## Primitif tampilan
34
34
 
@@ -54,6 +54,14 @@ nested + release idempoten). Pemegangnya: `askLine`/`askSecret`/`runPicker`
54
54
  tick `\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
55
55
  Menyiapkan sesi…").
56
56
 
57
+ Karena `screen.paint` kini mendiff secara inkremental, tulis ASING ke stderr
58
+ selama alt-screen hidup (mis. `[hooks] skipped …`, warning provider) juga
59
+ menandai terminal "kotor" — `statusline.consumeScreenDrift()` yang dikonsumsi
60
+ layar untuk memaksa repaint penuh sekali pada paint berikutnya. `beginInteractiveScreen`
61
+ memasang wrapper stderr pada depth 0→1 supaya sinyal ini aktif bahkan tanpa
62
+ owner transient. Tanpa ini fragmen asing tetap menempel di baris yang kebetulan
63
+ tak berubah.
64
+
57
65
  ## Invariant I1–I35
58
66
 
59
67
  Peta lengkap 35 invariant + test proteksinya (mis. `tui-app`, `screen-buffer`,
@@ -62,7 +70,7 @@ Peta lengkap 35 invariant + test proteksinya (mis. `tui-app`, `screen-buffer`,
62
70
  pada invariant itu — mis. tak boleh menulis cursor-control ke stdout non-TTY,
63
71
  tak boleh mengandalkan alternate screen di jalur non-interaktif.
64
72
 
65
- Kontrak versi **v7.4** (2026-10-20) juga mencantumkan **peta gap proteksi**:
73
+ Kontrak versi **v7.12** (2026-11-10) juga mencantumkan **peta gap proteksi**:
66
74
  klaim yang implementasinya benar tetapi belum punya assertion penjaga. Baca
67
75
  saga itu sebelum menyatakan "sudah dijaga".
68
76
 
package/docs/tools.md CHANGED
@@ -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. Pembukaan memeriksa target canonical, boundary ulang, identitas handle `dev+ino`, dan hardlink (`safeOpenRead`) |
26
+ | `read_image` | Gambar → konteks model | Base64 utuh + lapor `(bytes mime, tokens)` via `estimateImageTokens`. Pembukaan memeriksa target canonical, boundary ulang, identitas handle `dev+ino`, dan hardlink (`safeOpenRead`). Guard file-size 2 MB, tetapi batas efektif lebih ketat: b64 dibatasi anggaran truncate kernel (`toolResultMaxTokens` 4096×4−200 ≈ 16 KB) agar gambar tak terpotong korup |
27
27
 
28
28
  Contoh paging:
29
29
 
@@ -47,7 +47,7 @@ read_file({ path: "src/big.ts", offset: 500, limit: 50 })
47
47
  | `bash` | Shell 30 dtk SIGTERM→SIGKILL | Tanpa `MINICODE_SANDBOX`: jalan di HOST (network tidak diisolasi, teraudit di step-traces). cwd jail (= cwd eksekusi, bukan process.cwd), env kredensial di-strip (`sanitizeSpawnEnv`), progres streaming, `background:true` + `bash_output`/`bash_kill`, sandbox docker/os optional. Request sandbox eksplisit tanpa backend = TOLAK (fail-closed); fallback host hanya via `MINICODE_SANDBOX_ALLOW_FALLBACK=1`. `background:true` ditolak saat `--sandbox` aktif dan di sub-agen |
48
48
  | `bash_output` | Output BARU job sejak baca terakhir | + exit status |
49
49
  | `bash_kill` | Stop job | SIGTERM lalu SIGKILL; tree-kill (`taskkill /T /F` di Windows, process-group di POSIX) |
50
- | `code_run` | Snippet python/node tanpa shell | Spawn langsung argv (tanpa shell agar `$(...)` tidak dieksekusi shell dulu). Wajib sandbox `os|docker`, network-isolated, cwd = session root. Fail-closed bila backend tak tersedia. Image default `node:22-alpine` hanya bawa node — python butuh `MINICODE_SANDBOX_IMAGE` yang menyediakannya |
50
+ | `code_run` | Snippet python/node tanpa shell | Spawn langsung argv (tanpa shell agar `$(...)` tidak dieksekusi shell dulu). Wajib sandbox `os|docker` (alias `bwrap`/`seatbelt`), network-isolated, cwd = session root. Fail-closed bila backend tak tersedia. Image default `node:22-alpine` hanya bawa node — python butuh `MINICODE_SANDBOX_IMAGE` yang menyediakannya |
51
51
 
52
52
  Background:
53
53
 
@@ -73,7 +73,7 @@ Batas `BASH_BACKGROUND_MAX_JOBS`; semua job mati saat CLI keluar.
73
73
  | Tool | Fungsi | Catatan |
74
74
  |---|---|---|
75
75
  | `web_fetch` | GET URL publik, 10 dtk, max 50k char | SSRF guard + DNS pinning, redirect manual ≤5 hop, body hard-cap 2 MB |
76
- | `web_search` | Search via DuckDuckGo/Tavily | Butuh `TAVILY_API_KEY` untuk Tavily; fallback DDG bila kosong |
76
+ | `web_search` | Search via Tavily/Brave/DuckDuckGo | Urutan: `TAVILY_API_KEY` → `BRAVE_API_KEY` → DDG html lite (tanpa key) |
77
77
 
78
78
  ## Memory & plan
79
79
 
@@ -90,7 +90,7 @@ Batas `BASH_BACKGROUND_MAX_JOBS`; semua job mati saat CLI keluar.
90
90
 
91
91
  | Tool | Fungsi | Catatan |
92
92
  |---|---|---|
93
- | `delegate_task` | Sub-agen isolasi `explore`/`plan` | Pool 3, context/memory/signal/budget terpisah, abort-aware. Di ASK, TTY meminta persetujuan dan non-TTY menolak; AUTO berjalan tanpa prompt bila authorized. Parent PermissionMode `ASK`/`plan`/`readonly` memaksa `explore`; WorkMode `DISCUSS`/`PLAN` membatasi tool anak ke subset eksplorasi. Anak tidak mendapat MCP, commit, memory/todo writes, nesting, atau job background. Satu approval mencakup satu delegasi; turn gagal setelah anak committed → warning `[recovery]` |
93
+ | `delegate_task` | Sub-agen isolasi `explore`/`plan` | Pool 3, context/memory/signal/budget terpisah, abort-aware. Di ASK, TTY meminta persetujuan dan non-TTY menolak; AUTO berjalan tanpa prompt bila authorized. Parent PermissionMode `ASK`/`plan`/`readonly` memaksa `explore`; WorkMode `DISCUSS`/`PLAN` membatasi tool anak ke subset eksplorasi. Anak tidak mendapat commit, memory/todo writes, nesting, atau job background; tool MCP built-in (`mcp_call`/`mcp_read`/`mcp_prompt`) hanya ikut pada mode anak `plan` di bawah `BUILD`. Satu approval mencakup satu delegasi; turn gagal setelah anak committed → warning `[recovery]` |
94
94
 
95
95
  ## MCP
96
96
 
@@ -11,8 +11,8 @@ minicode doctor [--json] # runtime, provider, pricing, memory, sandbox, config
11
11
  ## FAQ
12
12
 
13
13
  - **LSP tidak jalan:** `minicode config lsp add .ts --command typescript-language-server --args --stdio`. Pastikan server terinstall.
14
- - **Docker sandbox:** `docker pull node:22-alpine`. Daemon mati → turun ke `allowlist`, bukan tanpa isolasi.
15
- - **Perintah aman ditolak?** Kemungkinan default `allowlist` karena tanpa OS sandbox. Pesan `[sandbox]` di awal run menjelaskannya. Pilih `--allow-all`/`--ask`, atau `bun experiments/bash-bypass-probe.ts` untuk lihat yang dianggap sah.
14
+ - **Docker sandbox:** `docker pull node:22-alpine`. Daemon mati saat `--sandbox docker` → run **DITOLAK** (fail-closed), bukan turun diam-diam; set `MINICODE_SANDBOX_ALLOW_FALLBACK=1` untuk fallback host yang sadar.
15
+ - **Perintah aman ditolak?** Kemungkinan default `allowlist` karena tanpa OS sandbox. Pesan `[sandbox]` hanya dicetak untuk request `--sandbox` eksplisit — fallback implicit senyap. Pilih `--allow-all`/`--ask`, atau `bun experiments/bash-bypass-probe.ts` untuk lihat yang dianggap sah.
16
16
  - **`--sandbox os` tak berefek:** bwrap/seatbelt tidak ada di Windows. Pakai `--sandbox docker`.
17
17
  - **Env hilang di subprocess:** hanya kata-kunci kredensial di-strip. `GITHUB_WORKSPACE`/`REDIS_HOST`/`AWS_REGION` tetap ada; `GITHUB_TOKEN`/`AWS_SECRET_ACCESS_KEY`/`DATABASE_URL` di-strip. Bila non-rahasia ikut hilang, itu bug — laporkan nama variabelnya.
18
18
  - **`grep` lambat:** install `rg`. Bandingkan dengan `MINICODE_GREP_ENGINE=js`.
@@ -21,7 +21,7 @@ minicode doctor [--json] # runtime, provider, pricing, memory, sandbox, config
21
21
  - **MCP "redirect tidak diikuti":** perbaiki URL; redirect sengaja tidak diikuti.
22
22
  - **`auth login` gagal:** error server ditampilkan apa adanya. Cek `minicode auth list`.
23
23
  - **Provider OAuth hilang:** belum login / refresh gagal. `minicode auth status` → `auth login <id>`.
24
- - **`git_commit` ditolak:** di-gate; non-TTY selalu tolak. Itu perilaku yang diinginkan.
24
+ - **`git_commit` ditolak:** di-gate. Ditolak di non-TTY pada `ASK`/`readonly`/`plan`/`allowlist`; di `AUTO` yang terotorisasi ia jalan tanpa prompt, dan di `ASK`+TTY ia minta izin sekali. Itu perilaku yang diinginkan.
25
25
  - **Biaya N/A:** `minicode pricing sync` → `pricing show <model>`.
26
26
  - **File besar tak terbaca:** pakai `offset`/`limit` (`read_file` >2 MB memang menolak tanpa itu).
27
27
  - **Background job tak jalan:** `background:true` ditolak saat `--sandbox` aktif.
@@ -67,8 +67,5 @@ SWE-bench Lite: `bench/swebench.ts` + `bench/swebench_lite_20.jsonl` (20 instanc
67
67
  Eksperimen adversarial (terpisah dari gate default):
68
68
 
69
69
  ```bash
70
- bun run extreme:fuzz # fuzz bash-guard (--seed N reproduksi)
71
- bun run extreme:git # stress shadow-git (--files N --sessions N)
72
- bun run extreme:mcp # server MCP jahat (hang, flood, redirect, SSRF)
73
70
  bun experiments/bash-bypass-probe.ts # postur denylist (0 bypass = lulus)
74
71
  ```