minicode-ai 0.15.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +6 -4
  2. package/cli/commands/exec.ts +3 -2
  3. package/cli/commands/openwork.ts +1 -1
  4. package/cli/commands.ts +6 -6
  5. package/cli/index.ts +4 -4
  6. package/cli/model-manager.ts +1 -1
  7. package/cli/setup.ts +57 -30
  8. package/cli/tui.ts +106 -11
  9. package/docs/CONTROL-PLANE-MAP.md +6 -4
  10. package/docs/OUTPUT_EVENT_MODEL.md +4 -3
  11. package/docs/OUTPUT_PROTOCOL_SPEC.md +1 -1
  12. package/docs/OUTPUT_RENDERING_SPEC.md +16 -4
  13. package/docs/OUTPUT_UX_RULES.md +38 -32
  14. package/docs/P14_OPEN_WORK.md +290 -0
  15. package/docs/README.md +1 -1
  16. package/docs/SUMMARY.md +36 -22
  17. package/docs/TERMINAL_CONTRACT.md +54 -7
  18. package/docs/UI_RENDER_PIPELINE.md +47 -8
  19. package/docs/agents.md +1 -1
  20. package/docs/architecture.md +9 -8
  21. package/docs/autonomous-scheduler.md +142 -0
  22. package/docs/choosing-mode.md +2 -2
  23. package/docs/cli.md +4 -4
  24. package/docs/concepts.md +5 -5
  25. package/docs/config-providers.md +3 -3
  26. package/docs/contributing.md +7 -9
  27. package/docs/environment.md +5 -4
  28. package/docs/getting-started.md +4 -4
  29. package/docs/mcp-lsp.md +2 -2
  30. package/docs/memory-sessions.md +1 -1
  31. package/docs/policy-sandbox.md +7 -4
  32. package/docs/pricing-budget.md +3 -3
  33. package/docs/quickstart.md +1 -1
  34. package/docs/repl.md +5 -5
  35. package/docs/security-model.md +1 -1
  36. package/docs/security.md +9 -8
  37. package/docs/skills.md +2 -2
  38. package/docs/terminal.md +10 -2
  39. package/docs/tools.md +4 -4
  40. package/docs/troubleshooting.md +3 -3
  41. package/docs/verify-benchmark.md +0 -3
  42. package/package.json +9 -18
  43. package/src/app/session.ts +40 -7
  44. package/src/constants.ts +31 -0
  45. package/src/hooks/run.ts +5 -6
  46. package/src/mcp/http-transport.ts +1 -1
  47. package/src/policy/bash-guard.ts +26 -6
  48. package/src/policy/compaction.ts +107 -17
  49. package/src/policy/consequence-engine.ts +3 -3
  50. package/src/policy/context-window.ts +24 -1
  51. package/src/policy/context.ts +16 -4
  52. package/src/policy/permission.ts +219 -4
  53. package/src/presentation/adapter.ts +1 -1
  54. package/src/presentation/events.ts +2 -2
  55. package/src/presentation/label.ts +3 -3
  56. package/src/presentation/model.ts +4 -0
  57. package/src/presentation/store.ts +2 -2
  58. package/src/runtime/child-execution.ts +1 -1
  59. package/src/runtime/composition.ts +5 -5
  60. package/src/runtime/execution-registry.ts +1 -1
  61. package/src/runtime/production-execution.ts +3 -3
  62. package/src/runtime/production-runtime.ts +2 -2
  63. package/src/runtime/runtime-capabilities.ts +1 -1
  64. package/src/runtime/runtime-status-facts.ts +1 -1
  65. package/src/runtime/runtime-task-admission.ts +2 -2
  66. package/src/session/context-assembly.ts +8 -1
  67. package/src/session/context-identity.ts +2 -2
  68. package/src/session/context-projection.ts +36 -11
  69. package/src/session/persistence.ts +1 -1
  70. package/src/task/autonomous-context.ts +2 -2
  71. package/src/task/autonomous-policy.ts +3 -3
  72. package/src/task/model.ts +2 -2
  73. package/src/task/production-scheduler.ts +2 -2
  74. package/src/task/scheduler.ts +3 -2
  75. package/src/task/scheduling-policy.ts +2 -1
  76. package/src/task/trigger.ts +5 -5
  77. package/src/tools/read_image.ts +2 -1
  78. package/src/tools/task.ts +1 -1
  79. package/src/ui/assistant/simple.ts +33 -30
  80. package/src/ui/footer.ts +48 -9
  81. package/src/ui/i18n/en.ts +1 -0
  82. package/src/ui/i18n/id.ts +1 -0
  83. package/src/ui/input/prompt-engine.ts +36 -10
  84. package/src/ui/render/cells.ts +320 -0
  85. package/src/ui/render/composer-wrap.ts +73 -0
  86. package/src/ui/render/detail.ts +2 -2
  87. package/src/ui/render/ledger.ts +47 -0
  88. package/src/ui/render/theme.ts +32 -4
  89. package/src/ui/render/width.ts +2 -2
  90. package/src/ui/render/wrap.ts +5 -3
  91. package/src/ui/runtime/screen.ts +84 -7
  92. package/src/ui/runtime/statusline.ts +26 -0
  93. package/src/ui/screens/model-manager.ts +1 -1
  94. package/src/ui/tui/app.ts +336 -65
  95. package/src/ui/tui/transcript.ts +247 -88
  96. package/vendor/minicore/VENDOR.md +15 -11
  97. package/vendor/minicore/src/core/events.ts +1 -0
  98. package/vendor/minicore/src/core/loop.ts +10 -0
  99. package/vendor/minicore/src/core/session.ts +39 -0
@@ -34,10 +34,10 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
34
34
  | `MINICODE_LANG` | `en`/`id` → bahasa UI (prioritas lengkap di kontrak terminal §i18n: `/lang` > env ini > state.json > locale OS > en) |
35
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) |
36
36
  | `MINICODE_DEBUG_STARTUP` | `1` → cetak durasi tiap tahap setup sesi ke stderr (diagnosis startup lambat; diagnostik saja, bukan perilaku) |
37
- | `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` |
38
38
  | `MINICODE_KEYSTORE_DISABLE` | `1` → matikan keystore OS seluruhnya (jatuh ke penyimpanan file; untuk CI/headless yang tak punya keychain/DPAPI) |
39
39
  | `MINICODE_KEYSTORE_FORCE_DPAPI` | `1`/`true` → paksa jalur DPAPI/Windows walau di non-Windows (khusus test portabilitas; bukan konfigurasi produksi) |
40
- | `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 |
41
41
 
42
42
  ## Sandbox
43
43
 
@@ -59,6 +59,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
59
59
  | `MINICODE_COMPACT_KEEP_TURNS` | Override keepRecentTurns kompaksi (bilangan ≥1; invalid → default kernel + warn) |
60
60
  | `MINICODE_MEMORY_SCOPE` | Scope baca memory: `cwd` (default) \| `global` \| `all` (gabung, tanpa silent shadowing) |
61
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 |
62
63
  | `MINICODE_REPOMAP` | `regex` → paksa repo-map regex (skip LSP) |
63
64
  | `TAVILY_API_KEY` | API key untuk Tavily web_search (fallback DuckDuckGo bila kosong) |
64
65
 
@@ -76,7 +77,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
76
77
  |---|---|
77
78
  | `MINICODE_ASCII` | `1` → paksa glyph ASCII (`[OK]`, `>`, `.`) untuk konsol tanpa UTF-8 |
78
79
  | `MINICODE_COMPACT` | `1` → tool call ringkas, `0` → expanded. Default: compact di TUI, expanded di one-shot/exec (juga `/compact`, Ctrl+O) |
79
- | `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 |
80
81
  | `MINICODE_DROPDOWN` | `0` → matikan floating dropdown, pakai hint inline (konsol legacy) |
81
82
  | `MINICODE_MOUSE_SELECTION` | `0`/`false`/`off`/`no` → matikan mouse tracking TUI; default `1` untuk drag selection + wheel |
82
83
  | `MINICODE_MOTION` | `0` → matikan animasi status (pulse spark saat turn berjalan jadi glyph statis) — aksesibilitas/rekaman layar/SSH lambat |
@@ -85,7 +86,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
85
86
  | `MINICODE_A11Y` | `1` → live-region approval untuk screen reader (baris polos tanpa ANSI) |
86
87
  | `MINICODE_SHOW_THINKING` | reasoning model terlihat SECARA DEFAULT; `0` → minimized (hanya penanda), `1` → paksa terlihat |
87
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`) |
88
- | `MINICODE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek) |
89
+ | `MINICORE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek). Alias lama `MINICODE_THINKING` masih dihormati |
89
90
  | `NO_COLOR` | Set apa pun selain `0` → matikan seluruh warna |
90
91
 
91
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
 
@@ -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
 
@@ -60,7 +60,7 @@ Batas konteks dibaca per model dari `providers[].contextWindows` (exact model ID
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
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.
@@ -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,12 +1,12 @@
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
@@ -62,8 +62,8 @@ Did-you-mean: typo `/sessoons` → `Did you mean /sessions?` (jarak ≤ 2).
62
62
  | `ctrl+o` | Putar tool call compact/expanded (juga `/compact`) |
63
63
  | `ctrl+t` | Toggle tampilan thinking expanded/minimized (juga `/thinking`) |
64
64
  | `esc` | Tutup dropdown/picker; dua-tahap di form (tekan-1 bersihkan field, tekan-2 batal); busy = batalkan turn |
65
- | `ctrl+c` | Batalkan input/prompt; pada turn TUI gunakan `Esc` untuk abort |
66
- | `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 |
67
67
 
68
68
  ## Aturan konsistensi (kontrak I25)
69
69
 
@@ -87,7 +87,7 @@ Kejujuran yang disengaja: crash ambiguity TETAP MUNGKIN (filesystem dan database
87
87
 
88
88
  ## Security Contact
89
89
 
90
- 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`.
91
91
 
92
92
  ## Lanjut
93
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
  ```
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.15.0",
4
- "description": "Coding agent CLI built on the frozen MiniCore runtime — tools, MCP, LSP, sandbox, shadow-git checkpoints",
3
+ "version": "0.20.0",
4
+ "description": "Open-source terminal coding agent on a frozen zero-dependency MiniCore kernel — layered permissions, path jail, sandboxing, MCP/LSP, and durable shadow-git checkpoints",
5
5
  "type": "module",
6
6
  "private": false,
7
7
  "publishConfig": {
@@ -24,13 +24,13 @@
24
24
  "anthropic",
25
25
  "ollama"
26
26
  ],
27
- "homepage": "https://minicode.fun",
27
+ "homepage": "https://minilabs.id/projects/minicode/",
28
28
  "repository": {
29
29
  "type": "git",
30
- "url": "git+https://github.com/startupmini/minicode.git"
30
+ "url": "git+https://github.com/minilabs-id/minicode.git"
31
31
  },
32
32
  "bugs": {
33
- "url": "https://github.com/startupmini/minicode/issues"
33
+ "url": "https://github.com/minilabs-id/minicode/issues"
34
34
  },
35
35
  "bin": {
36
36
  "minicode": "cli/minicode.js"
@@ -55,11 +55,13 @@
55
55
  "docs/OUTPUT_PROTOCOL_SPEC.md",
56
56
  "docs/OUTPUT_RENDERING_SPEC.md",
57
57
  "docs/OUTPUT_UX_RULES.md",
58
+ "docs/P14_OPEN_WORK.md",
58
59
  "docs/SUMMARY.md",
59
60
  "docs/TERMINAL_CONTRACT.md",
60
61
  "docs/UI_RENDER_PIPELINE.md",
61
62
  "docs/agents.md",
62
63
  "docs/architecture.md",
64
+ "docs/autonomous-scheduler.md",
63
65
  "docs/choosing-mode.md",
64
66
  "docs/cli.md",
65
67
  "docs/concepts.md",
@@ -91,14 +93,9 @@
91
93
  "test:qa": "bun scripts/live-qa.ts",
92
94
  "test:coverage": "bun test --coverage",
93
95
  "gate:fast": "bun x tsc --noEmit && bun run lint && bun test && bun run gate:coverage && bun run gate:pack && bun run gate:bash && bun run bench:smoke && bun run audit:harness",
94
- "gate:slow": "bun experiments/extreme-bash-fuzz.ts --rounds 12 && bun experiments/extreme-shadow-git.ts && bun experiments/extreme-mcp-adversarial.ts",
95
96
  "gate:coverage": "bun scripts/coverage-gate.ts",
96
97
  "gate:bash": "bun experiments/bash-bypass-probe.ts && bun experiments/bash-bypass-probe.ts --mode allowlist",
97
98
  "gate:pack": "bun scripts/pack-check.ts",
98
- "extreme": "bun experiments/extreme-bash-fuzz.ts && bun experiments/extreme-shadow-git.ts && bun experiments/extreme-mcp-adversarial.ts",
99
- "extreme:fuzz": "bun experiments/extreme-bash-fuzz.ts --rounds 12",
100
- "extreme:git": "bun experiments/extreme-shadow-git.ts",
101
- "extreme:mcp": "bun experiments/extreme-mcp-adversarial.ts",
102
99
  "vendor:minicore": "bun scripts/vendor-minicore.ts",
103
100
  "vendor:check": "bun scripts/vendor-minicore.ts --check",
104
101
  "typecheck": "bun x tsc --noEmit",
@@ -110,21 +107,15 @@
110
107
  "bench": "bun bench/runner.ts",
111
108
  "bench:smoke": "bun bench/runner.ts --fake",
112
109
  "bench:render": "bun scripts/bench-render.ts",
110
+ "bench:typing": "bun scripts/bench-typing.ts",
113
111
  "gate:eval": "bun bench/eval-gate.ts",
114
112
  "audit:harness": "bun bench/harness-audit.ts",
115
- "bench:runs": "bun bench/runner.ts --runs 2",
116
- "web:css": "bun scripts/build-web-css.ts",
117
- "web:build": "bun scripts/build-web-css.ts && bun scripts/build-web.ts",
118
- "web:serve": "bun --hot scripts/web-serve.ts",
119
- "web:check": "bun scripts/web-check.ts",
120
- "web:indexnow": "bun scripts/web-indexnow.ts",
121
- "web:vitals": "bun scripts/web-vitals.ts"
113
+ "bench:runs": "bun bench/runner.ts --runs 2"
122
114
  },
123
115
  "dependencies": {},
124
116
  "devDependencies": {
125
117
  "@biomejs/biome": "2.5.10",
126
118
  "@lydell/node-pty": "1.2.0-beta.15",
127
- "@resvg/resvg-js": "^2.6.2",
128
119
  "@types/bun": "^1.3.14",
129
120
  "@types/node": "^26.2.0",
130
121
  "typescript": "^7.0.2"
@@ -598,7 +598,10 @@ export async function createMinicodeSession(
598
598
  }
599
599
  // Sisakan ruang framing dan respons minimum. Tanpa reserve, request yang
600
600
  // tepat menyentuh batas provider tetap ditolak setelah biaya dibakar.
601
- let reserve = Math.min(256, Math.floor(limit / 10))
601
+ // Reserve ini HANYA headroom framing + respons minimum (skema tool sudah
602
+ // termasuk di `inputTokens` via estimateTools), jadi cap 256 cukup —
603
+ // tidak perlu diskala dengan ukuran skema tool.
604
+ let reserve = Math.min(LIMITS.CONTEXT_WINDOW_RESERVE_CAP_TOKENS, Math.floor(limit / 10))
602
605
  let outputAllowance = Math.max(0, limit - inputTokens - reserve)
603
606
  let outputTokens = 0
604
607
  const streamedText = createIncrementalTokenCounter()
@@ -662,7 +665,7 @@ export async function createMinicodeSession(
662
665
  estimateSystem(system, estimator) +
663
666
  estimateTools(tools, estimator),
664
667
  )
665
- reserve = Math.min(256, Math.floor(limit / 10))
668
+ reserve = Math.min(LIMITS.CONTEXT_WINDOW_RESERVE_CAP_TOKENS, Math.floor(limit / 10))
666
669
  outputAllowance = Math.max(0, limit - inputTokens - reserve)
667
670
  }
668
671
  }
@@ -674,7 +677,7 @@ export async function createMinicodeSession(
674
677
  estimateSystem(system, estimator) +
675
678
  estimateTools(tools, estimator),
676
679
  )
677
- reserve = Math.min(256, Math.floor(limit / 10))
680
+ reserve = Math.min(LIMITS.CONTEXT_WINDOW_RESERVE_CAP_TOKENS, Math.floor(limit / 10))
678
681
  outputAllowance = Math.max(0, limit - inputTokens - reserve)
679
682
  }
680
683
  admittedFactor = currentFactor
@@ -703,13 +706,14 @@ export async function createMinicodeSession(
703
706
  // sebenarnya konteks kepanjangan meski teksnya tak menyebut "context".
704
707
  // Reklasifikasi sebagai context_length_exceeded supaya kernel menempuh
705
708
  // compact-and-retry (bounded + no-op-safe) alih-alih mati fatal. Ambang
706
- // `localInputTokens >= 50_000` = proxy monotonik ukuran konteks berbasis
707
- // chars/4 (toleran terhadap under-count estimator); sesi kecil dengan
708
- // 400 format-argumen yang sah tidak akan salah diklasifikasi.
709
+ // `localInputTokens >= CONTEXT_RECLASSIFY_400_MIN_LOCAL_TOKENS` = proxy
710
+ // monotonik ukuran konteks berbasis chars/token estimator (toleran
711
+ // terhadap under-count); sesi kecil dengan 400 format-argumen yang sah
712
+ // tidak akan salah diklasifikasi.
709
713
  if (
710
714
  error instanceof ProviderError &&
711
715
  (error.category === "invalid_request" || error.category === "unknown") &&
712
- localInputTokens >= 50_000
716
+ localInputTokens >= LIMITS.CONTEXT_RECLASSIFY_400_MIN_LOCAL_TOKENS
713
717
  ) {
714
718
  throw overflow(inputTokens, outputTokens)
715
719
  }
@@ -819,6 +823,35 @@ export async function createMinicodeSession(
819
823
  detector.noteAssistantResponse()
820
824
  })
821
825
  }
826
+ // R11/T3 (opt-in, default off) — anggaran volume-baca per turn. Guard token
827
+ // hanya peka tekanan TOKEN, bukan tekanan working-memory: model berjendela
828
+ // raksasa (1M) bisa membaca ribuan baris tanpa memicu kompaksi, lalu
829
+ // kualitas nalarnya menurun diam-diam (lih. evidence dogfooding: audit UI
830
+ // berhenti minta-konfirmasi setelah membaca ~5k baris tanpa kompaksi).
831
+ // Observer ini MENGHITUNG total char hasil tool per turn dan memperingatkan
832
+ // sekali bila melewati ambang — membantu operator mengenali kasus "penuh
833
+ // karena perhatian, bukan jendela". Opt-in lewat MINICODE_READ_VOLUME_GUARD=1
834
+ // supaya perilaku default TIDAK berubah.
835
+ if (process.env.MINICODE_READ_VOLUME_GUARD === "1") {
836
+ let turnReadChars = 0
837
+ let warnedThisTurn = false
838
+ core.events.on("execution:completed", (e) => {
839
+ if ((e as { forwardedChild?: unknown }).forwardedChild != null) return
840
+ const result = e.execution?.result as { content?: unknown } | undefined
841
+ const text = typeof result?.content === "string" ? result.content : ""
842
+ turnReadChars += text.length
843
+ if (!warnedThisTurn && turnReadChars > LIMITS.TURN_READ_VOLUME_GUARD_CHARS) {
844
+ warnedThisTurn = true
845
+ process.stderr.write(
846
+ `[context] read-volume tinggi turn ini (${turnReadChars} chars ≈ ${Math.round(turnReadChars / 4)} token) tanpa kompaksi — bila task panjang, minta model menulis progres ke file/memory agar fakta tak hilang.\n`,
847
+ )
848
+ }
849
+ })
850
+ core.events.on("turn:completed", () => {
851
+ turnReadChars = 0
852
+ warnedThisTurn = false
853
+ })
854
+ }
822
855
  if (safeMaxTurns !== undefined) {
823
856
  const origRun = core.run.bind(core)
824
857
  core.run = async (input, runOpts) => {
package/src/constants.ts CHANGED
@@ -32,7 +32,38 @@ export const LIMITS = {
32
32
  MEMORY_TRUNCATE_KEEP_BYTES: 150_000,
33
33
  AGENTS_MD_MAX_CHARS: 3_000,
34
34
  COMPACTION_SUMMARY_MAX_CHARS: 4_000,
35
+ /** R9 — pagu langit-langit ringkasan kompaksi LLM untuk model berjendela
36
+ * raksasa. Ringkasan diskala mengikuti jendela lewat
37
+ * `summaryCharBudgetForWindow` (lantai = COMPACTION_SUMMARY_MAX_CHARS, atap =
38
+ * nilai ini ≈ 8k token), bukan 4k char konstan yang membuat model 1M
39
+ * over-discard fakta lama. */
40
+ COMPACTION_SUMMARY_SCALED_MAX_CHARS: 32_000,
41
+ /** R10/B — lantai & atap input summarizer kompaksi LLM (`scrubbedPrefix`).
42
+ * Sebelumnya hard-coded 6000 char = titik sempit nyata: summarizer hanya
43
+ * melihat ≤6000 char prefix (≈1500 token), sehingga ringkasan tak bisa lebih
44
+ * kaya dari yang terbaca. Diskala lewat `summaryInputCharBudget`, atap ≈
45
+ * 12k token input untuk model berjendela raksasa. */
46
+ COMPACTION_LLM_INPUT_MIN_CHARS: 6_000,
47
+ COMPACTION_LLM_INPUT_SCALED_MAX_CHARS: 48_000,
48
+ /** F3.2/R9 — rasio target ringkasan terhadap jendela konteks saat kompaksi
49
+ * mekanikal/LLM menarget budget token (0.5 = target 50% jendela). Sebelumnya
50
+ * angka 0.5 tersebar inline di compaction.ts tanpa nama (magic number). */
51
+ COMPACTION_SUMMARY_TARGET_RATIO: 0.5,
35
52
  COMPACTION_LLM_TIMEOUT_MS: 10_000,
53
+ /** Batas atas cadangan output (framing + respons minimum) saat admission
54
+ * request provider: `Math.min(reserve, limit/10)` — cadangan tak naik tanpa
55
+ * batas pada jendela raksasa (1M token tetap cukup 256 untuk framing). */
56
+ CONTEXT_WINDOW_RESERVE_CAP_TOKENS: 256,
57
+ /** Ambang ukuran konteks (estimasi chars/token lokal) untuk mengklasifikasi
58
+ * 400 `invalid_request` generik sebagai `context_length_exceeded` alih-alih
59
+ * mati fatal. Di bawah ambang ini, 400 dianggap error format sah (bukan
60
+ * konteks). Proxy monotonik ukuran konteks, bukan hitungan presisi. */
61
+ CONTEXT_RECLASSIFY_400_MIN_LOCAL_TOKENS: 50_000,
62
+ /** R11 — ambang volume-baca per turn (char hasil tool terakumulasi) untuk
63
+ * observer opt-in `MINICODE_READ_VOLUME_GUARD=1`. Di atas ini, peringatkan
64
+ * sekali per turn: "banyak dibaca tanpa kompaksi" = risiko degradasi
65
+ * working-memory (bukan jendela token). Default 200k char ≈ 50k token. */
66
+ TURN_READ_VOLUME_GUARD_CHARS: 200_000,
36
67
  /** F3.1 anti-thrash: kompaksi LLM yang mengurangi <10% dihitung tak
37
68
  * berprogres (satu output tool raksasa mendominasi jendela); 2× beruntun
38
69
  * = thrash → jalur LLM dimatikan sesi-ini (mekanikal saja). */