minicode-ai 0.23.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +5 -3
  2. package/cli/commands/config.ts +123 -0
  3. package/cli/setup.ts +107 -8
  4. package/cli/tui.ts +28 -2
  5. package/docs/README.md +2 -2
  6. package/docs/SUMMARY.md +10 -19
  7. package/docs/TERMINAL_CONTRACT.md +113 -28
  8. package/docs/architecture.md +1 -1
  9. package/docs/autonomous-scheduler.md +283 -2
  10. package/docs/choosing-mode.md +4 -4
  11. package/docs/concepts.md +39 -3
  12. package/docs/config.md +103 -5
  13. package/docs/environment.md +4 -0
  14. package/docs/getting-started.md +69 -5
  15. package/docs/repl.md +1 -1
  16. package/docs/security.md +49 -2
  17. package/docs/tools.md +2 -1
  18. package/package.json +2 -36
  19. package/src/app/provider-layer.ts +1 -1
  20. package/src/app/session.ts +187 -17
  21. package/src/config.ts +21 -8
  22. package/src/constants.ts +17 -1
  23. package/src/lib/net.ts +6 -15
  24. package/src/lib/public-http.ts +128 -0
  25. package/src/lib/safe-open.ts +21 -12
  26. package/src/memory/vector.ts +0 -31
  27. package/src/policy/auto-resume.ts +63 -0
  28. package/src/policy/compaction.ts +354 -70
  29. package/src/policy/context-budget.ts +4 -6
  30. package/src/policy/context-window-assign.ts +114 -0
  31. package/src/policy/context-window-catalog.ts +4 -1
  32. package/src/policy/context-window-presets.ts +165 -0
  33. package/src/policy/context-window.ts +19 -37
  34. package/src/policy/context.ts +11 -9
  35. package/src/policy/executor.ts +69 -27
  36. package/src/policy/microcompact.ts +76 -15
  37. package/src/policy/no-progress.ts +1 -1
  38. package/src/policy/permission.ts +5 -0
  39. package/src/policy/recovery-budget.ts +281 -0
  40. package/src/policy/scrub.ts +15 -2
  41. package/src/policy/step-escalation.ts +82 -0
  42. package/src/policy/tokenizer-registry.ts +1 -0
  43. package/src/policy/tool-contract.ts +11 -9
  44. package/src/presentation/reducer.ts +1 -0
  45. package/src/providers/anthropic.ts +3 -3
  46. package/src/providers/detect.ts +40 -7
  47. package/src/providers/provision.ts +23 -1
  48. package/src/runtime/child-execution.ts +4 -2
  49. package/src/runtime/execution-backend.ts +3 -0
  50. package/src/sandbox/os.ts +53 -9
  51. package/src/session/context-assembly.ts +11 -7
  52. package/src/session/persistence.ts +19 -3
  53. package/src/task/autonomous-policy.ts +7 -0
  54. package/src/task/graph-validate.ts +1 -1
  55. package/src/task/session-authority.ts +0 -5
  56. package/src/task/store.ts +0 -4
  57. package/src/tools/ask_user.ts +14 -1
  58. package/src/tools/bash.ts +68 -17
  59. package/src/tools/code_run.ts +19 -20
  60. package/src/tools/context.ts +10 -0
  61. package/src/tools/delete_file.ts +3 -2
  62. package/src/tools/edit.ts +5 -4
  63. package/src/tools/git.ts +70 -12
  64. package/src/tools/glob.ts +13 -5
  65. package/src/tools/grep.ts +26 -10
  66. package/src/tools/index.ts +3 -2
  67. package/src/tools/lsp.ts +15 -9
  68. package/src/tools/move_file.ts +4 -3
  69. package/src/tools/patch.ts +5 -4
  70. package/src/tools/read_file.ts +3 -2
  71. package/src/tools/read_image.ts +3 -2
  72. package/src/tools/task.ts +5 -1
  73. package/src/tools/todo.ts +4 -8
  74. package/src/tools/web_fetch.ts +13 -19
  75. package/src/tools/write_file.ts +4 -3
  76. package/src/ui/approval/prompt.ts +226 -77
  77. package/src/ui/assistant/simple.ts +61 -10
  78. package/src/ui/footer.ts +41 -29
  79. package/src/ui/i18n/en.ts +7 -0
  80. package/src/ui/i18n/id.ts +7 -0
  81. package/src/ui/input/prompt-engine.ts +53 -21
  82. package/src/ui/render/activity-group.ts +9 -0
  83. package/src/ui/render/activity-panel.ts +20 -2
  84. package/src/ui/render/ledger.ts +1 -9
  85. package/src/ui/render/logo.ts +0 -5
  86. package/src/ui/render/markdown-table.ts +0 -3
  87. package/src/ui/render/table-grid.ts +0 -3
  88. package/src/ui/render/theme.ts +31 -5
  89. package/src/ui/runtime/screen.ts +7 -1
  90. package/src/ui/screens/dialog.ts +45 -81
  91. package/src/ui/screens/form.ts +10 -10
  92. package/src/ui/screens/model-manager.ts +7 -10
  93. package/src/ui/screens/picker.ts +8 -11
  94. package/src/ui/screens/provider-manager.ts +9 -13
  95. package/src/ui/tui/app.ts +118 -20
  96. package/src/ui/tui/transcript.ts +179 -29
  97. package/vendor/minicore/src/core/loop.ts +20 -1
  98. package/vendor/minicore/src/core/session.ts +6 -0
  99. package/docs/P14_OPEN_WORK.md +0 -290
  100. package/docs/config-providers.md +0 -87
  101. package/docs/glossary.md +0 -39
  102. package/docs/quickstart.md +0 -60
  103. package/docs/security-model.md +0 -96
  104. package/docs/terminal.md +0 -91
package/docs/config.md CHANGED
@@ -1,6 +1,6 @@
1
- # Config — File & Lokasi Data
1
+ # Config & Provider
2
2
 
3
- Di mana pengaturan dan data Minicode tinggal, dan bagaimana file lokal yang tak tepercaya diperlakukan.
3
+ Di mana pengaturan dan data Minicode tinggal, bagaimana file lokal yang tak tepercaya diperlakukan, dan provider mana yang bisa dipakai.
4
4
 
5
5
  ## Skema `.minicode/config.json`
6
6
 
@@ -20,12 +20,110 @@ Di mana pengaturan dan data Minicode tinggal, dan bagaimana file lokal yang tak
20
20
  }
21
21
  ```
22
22
 
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 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.
23
+ - `providers` — bisa juga diisi lewat wizard/`minicode config add`/`/provider`; lihat daftar preset di bawah.
24
+ - `providers[].contextWindows` — batas konteks dalam token per model; exact model ID menang, lalu key `"*"` menjadi fallback provider. Nilai boleh **angka** (`128000`) atau **string preset** (`"128k"`, `"1m"`, `"1024x1024"`, `"auto"`); `"auto"` berarti hapus nilai dan kembali ke deteksi otomatis. 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
+
26
+ **Provider yang tidak melaporkan kapasitas** (gateway lokal, endpoint kompatibel, alias): setel manual — nilai tersimpan berlabel `user` sehingga `minicode sync` **tidak** menimpanya:
27
+
28
+ ```bash
29
+ minicode config context-window # daftar semua nilai eksplisit
30
+ minicode config context-window <provider> # nilai satu provider
31
+ minicode config context-window <provider> <model> 128k
32
+ minicode config context-window <provider> <model> 1024x1024
33
+ minicode config context-window <provider> <model> auto # kembali deteksi otomatis
34
+ ```
35
+
36
+ Pilihan yang diterima mengikuti ukuran yang benar-benar dipakai model produksi: `16K`, `32K`, `64K`, `128K`, `200K`, `256K`, `400K`, `500K`, `1M`, `1M (1024²)`, `1.05M`, `2M`, `4M`, `10M`, ditambah angka eksak. **Tiga varian 1M** disengaja karena memang berbeda: `1000000` (Anthropic/DeepSeek/Qwen), `1048576` (Google/Gemini, Kimi, GLM), `1050000` (OpenAI) — selisihnya sampai ~50K token.
25
37
  - `mcpServers` — dua bentuk: stdio (`command`+`args`) dan HTTP (`url`+opsional `headers`). Detail transport di [MCP & LSP](mcp-lsp.md).
26
38
  - `verifyCommand` — dipakai `--verify` bila auto-detect tidak menemukan (urutan deteksi: `typecheck` → `test` → `tsconfig`).
27
39
  - `bashAllowlist` — pola koma/pola glob perintah bash yang dianggap aman (mode `allowlist`).
28
40
 
41
+ ## 15 preset gateway (termasuk Custom URL)
42
+
43
+ `Gateway >` hanya menampilkan `[0] Label` tanpa URL (minimalis, tanpa bocor endpoint).
44
+
45
+ | id | Label | Catatan |
46
+ |---|---|---|
47
+ | `openai` | OpenAI | gpt, o-series |
48
+ | `anthropic` | Anthropic | Claude, streaming `tool_use` |
49
+ | `openrouter` | OpenRouter | Gateway 75+ model |
50
+ | `deepseek` | DeepSeek | chat/reasoner |
51
+ | `opencode-zen` | OpenCode Zen | Gateway |
52
+ | `google` | Google Gemini | Konteks 1M, `thought_signature` pass-through |
53
+ | `ollama` | Ollama | Lokal, gratis, tanpa key |
54
+ | `qwen` | Qwen | Alibaba Qwen3-Coder (satu-satunya dengan spec OAuth terdaftar) |
55
+ | `groq` | Groq | Inferensi cepat |
56
+ | `together` | Together AI | Model terbuka |
57
+ | `fireworks` | Fireworks AI | — |
58
+ | `mistral` | Mistral AI | — |
59
+ | `cohere` | Cohere | — |
60
+ | `generic` | OpenAI-compatible umum | vLLM / LM Studio |
61
+ | `custom` | Custom URL | Pseudo-preset untuk baseUrl sendiri |
62
+
63
+ Alur: wizard & `/provider` (add `[0] OpenAI` … `[14] Custom URL`) → API key ter-masking → auto-detect models via `GET /models` timeout 4 dtk → provider otomatis pindah saat pilih model beda provider (tanpa restart, via `reloadProviders()` setelah `Gateway >2`).
64
+
65
+ ## Dua jalur autentikasi
66
+
67
+ ```bash
68
+ # 1. API key
69
+ minicode config add --baseUrl https://api.openai.com/v1 --apiKey sk-…
70
+
71
+ # 2. OAuth device-code (tanpa API key, tanpa kartu kredit) — RFC 8628
72
+ minicode auth list # provider yang mendukung
73
+ minicode auth login qwen # kode singkat → buka URL → tunggu persetujuan
74
+ minicode auth status # kredensial + kapan kedaluwarsa
75
+ minicode auth logout qwen
76
+ ```
77
+
78
+ 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.
79
+
80
+ > 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.
81
+
82
+ ## Keyring OS (ganti plaintext config)
83
+
84
+ ```bash
85
+ minicode config set-key openrouter # pindah API key ke OS store, config tinggal referensi
86
+ minicode config delete-key openrouter # lupakan (provider nonaktif sampai di-set ulang)
87
+ ```
88
+
89
+ Windows memakai DPAPI user-scope (hanya user ini yang bisa membuka); selain itu berkas chmod 600 dengan label jujur `plain-file` (bukan keyring). Referensi hilang/rusak = provider di-skip dengan peringatan (fail-closed, seperti OAuth). Matikan paksa via `MINICODE_KEYSTORE_DISABLE=1`.
90
+
91
+ ## Model & thinking effort
92
+
93
+ ```
94
+ /model [cari] → picker provider::model, bisa difilter
95
+ Enter → pilih model (+ picker effort bila modelnya mendukung)
96
+ Esc → batal total
97
+ ```
98
+
99
+ 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.
100
+
101
+ Model override sekali jalan:
102
+
103
+ ```bash
104
+ minicode --model providerId::modelName "prompt"
105
+ minicode --provider openai "prompt"
106
+ minicode models --match gemini
107
+ ```
108
+
109
+ `MINICODE_PROVIDER_ORDER=openai,anthropic,deepseek` mengurutkan provider agnostik tanpa edit config.
110
+
111
+ ## Pin eksplisit `provider::model` (kontrak)
112
+
113
+ Model berformat `providerId::modelName` = PIN: request hanya ke provider
114
+ itu — **tanpa fallback lintas provider dan tanpa substitusi diam-diam**.
115
+ Gagal = error jujur dari provider yang dipilih (limit/saldo/error server),
116
+ user memilih model lanjutannya sendiri via `/model`. Alasan: fallback
117
+ otomatis pernah melempar user dari model gratis ke model berbayar provider
118
+ lain (tagihan tak terduga). Model bare (tanpa `::`) tetap perilaku lama
119
+ (first-match + substitusi + fallback rate_limit/server/network).
120
+
121
+ ## Build & router
122
+
123
+ Build provider terpusat di `src/providers/build.ts`. Router fallback untuk rate_limit/server/network (clone-error + base64 fix + retryAfter cap). Deteksi wire dari probe path `/responses` → hint `responses`; substring host hanya fallback. `max_tokens` 8192; stop `length` = peringatan eksplisit, bukan teks sunyi.
124
+
125
+ Responses API: `/v1/responses`, `previous_response_id` chaining per model, `store:false` default.
126
+
29
127
  ## Global vs lokal
30
128
 
31
129
  | File | Lokasi | Catatan |
@@ -39,7 +137,7 @@ Merge dengan **prioritas lokal menang**. Mutasi (add/update provider, MCP, LSP)
39
137
 
40
138
  ## Token OAuth bukan di config
41
139
 
42
- Kredensial OAuth di `~/.minicode/auth.json` (chmod 600) — terpisah dari config karena config lokal rawan ikut ter-commit sedangkan token rahasia berumur pendek. Provider OAuth menyimpan `apiKey: ""` di config dan mengambil token saat runtime. Detail di [Config & Provider](config-providers.md).
140
+ Kredensial OAuth di `~/.minicode/auth.json` (chmod 600) — terpisah dari config karena config lokal rawan ikut ter-commit sedangkan token rahasia berumur pendek. Provider OAuth menyimpan `apiKey: ""` di config dan mengambil token saat runtime. Detail di [Config & Provider](config.md).
43
141
 
44
142
  ## Lokasi data
45
143
 
@@ -80,6 +80,8 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
80
80
  | Variabel | Fungsi |
81
81
  |---|---|
82
82
  | `MINICODE_ASCII` | `1` → paksa glyph ASCII (`[OK]`, `>`, `.`) untuk konsol tanpa UTF-8 |
83
+ | `MINICODE_BOX` | gaya sudut kotak popup: default **melengkung** (`╭╮╰╯`); `square` → lancip (`┌┐└┘`); `ascii` → `+-|` (sama dengan `MINICODE_ASCII=1`). Untuk terminal yang merender glyph melengkung jelek |
84
+ | `MINICODE_SCRIM` | `none` → paksa scrim backdrop jadi `faint` saja (tanpa latar gelap `48;5;236`) — diagnostik/tema terminal yang memetakan 256-warna aneh |
83
85
  | `MINICODE_COMPACT` | `1` → tool call ringkas, `0` → expanded. Default: compact di TUI, expanded di one-shot/exec (juga `/compact`, Ctrl+O) |
84
86
  | `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 |
85
87
  | `MINICODE_DROPDOWN` | `0` → matikan floating dropdown, pakai hint inline (konsol legacy) |
@@ -91,6 +93,8 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
91
93
  | `MINICODE_SHOW_THINKING` | reasoning model terlihat SECARA DEFAULT; `0` → minimized (hanya penanda), `1` → paksa terlihat |
92
94
  | `MINICODE_MINIMIZE_ACTIVITY` | ON secara default di TUI; `0` → transparan (baris per-tool). Lipat aktivitas tool per turn jadi satu ringkasan (detail via `/expand`) |
93
95
  | `MINICODE_ACTIVITY_PANEL` | `0` → matikan panel aktivitas (default AKTIF di TUI; `/fold` toggle); `1` → paksa aktif juga di jalur linear/one-shot |
96
+ | `MINICODE_AUTORESUME_BG` | `0` → nonaktifkan auto-resume turn TUI saat job background selesai (default aktif; sekali per job, hanya bila tidak ada turn berjalan) |
97
+ | `MINICODE_TURN_AUTO_RESUME` | `0` → nonaktifkan resume otomatis turn setelah kegagalan provider **transien** (`server`/`network`; default aktif). Retry provider dan resume turn berbagi **satu anggaran pemulihan** (`src/policy/recovery-budget.ts`): total 45 dtk dan kuota 6 percobaan untuk satu panggilan logis, dengan full jitter dan `Retry-After` sebagai floor. Berbagi satu anggaran mencegah *retry amplification* (angka terpisah per lapisan membuat biaya berkali: ≈82 dtk untuk provider mati). Kegagalan terminal tidak dipulihkan: `rate_limit` (429 permanen/spend-cap tidak pulih), `auth`, `invalid_request`, `context_length_exceeded`, `budget_exceeded`, `max_steps_exceeded`, dan abort user |
94
98
  | `MINICORE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek). Alias lama `MINICODE_THINKING` masih dihormati |
95
99
  | `NO_COLOR` | Set apa pun selain `0` → matikan seluruh warna |
96
100
 
@@ -1,4 +1,6 @@
1
- # Instalasi
1
+ # Instalasi & Quickstart
2
+
3
+ Dari nol sampai prompt pertama yang ter-verify: pasang, setup provider, jalankan, verifikasi.
2
4
 
3
5
  Prasyarat tunggal: **`bun >= 1.1.13`** — runtime Minicode, bukan Node.js. `npm` hanya dipakai untuk distribusi, bukan untuk menjalankan. (Lantai versi: kode memakai `AbortSignal.any()` yang absen di Bun 1.0.x; `minicode` gagal cepat dengan pesan jelas bila versi lebih lama.)
4
6
 
@@ -25,12 +27,20 @@ Cek: `bun --version` harus keluar versi ≥ `1.1.13` (contoh `1.4.x`). Kalau mas
25
27
  **Langkah 2 — Pasang Minicode:**
26
28
 
27
29
  ```bash
28
- npm install -g minicode-ai
30
+ bun add -g minicode-ai
29
31
  # bin: minicode
30
32
  minicode --version # pastikan versi terbaru terpasang
31
33
  ```
32
34
 
33
- Kenapa butuh keduanya? `npm` = toko distribusi, `Bun` = mesin yang menjalankan. Tanpa Bun, `minicode` gagal dengan `'bun' is not recognized`.
35
+ Minicode adalah paket Bun — memasangnya dengan `bun add -g` memakai runtime yang
36
+ sama dengan yang menjalankannya, tanpa perantara Node. Tanpa Bun di PATH,
37
+ `minicode` gagal dengan `'bun' is not recognized`.
38
+
39
+ Masih memakai npm? Itu tetap didukung dan menghasilkan bin yang sama:
40
+
41
+ ```bash
42
+ npm install -g minicode-ai
43
+ ```
34
44
 
35
45
  Untuk kontributor (kerja dari source):
36
46
 
@@ -50,6 +60,61 @@ bun test # offline/hermetic; live & docker di-skip otomatis
50
60
 
51
61
  Setup wizard berjalan otomatis saat `minicode` pertama kali bila belum ada provider.
52
62
 
63
+ ## Prompt pertama
64
+
65
+ Tujuan: dari nol sampai prompt pertama yang ter-verify, tanpa membaca seluruh manual.
66
+
67
+ ## 1. Jalan pertama (1 menit)
68
+
69
+ ```bash
70
+ minicode
71
+ ```
72
+
73
+ Bila belum ada provider, wizard setup muncul. Isi berurutan: pilih gateway → tempel API key (ter-masking) → auto-detect models. Wizard memakai picker (panah + filter), bukan `readline` nomor — mengetik di luar rentang tidak lagi diam-diam memilih `[0]`.
74
+
75
+ Alternatif tanpa API key:
76
+
77
+ ```bash
78
+ minicode auth login # device-code: kode singkat + URL, setujui di browser
79
+ minicode auth status # lihat kredensial + kapan kedaluwarsa
80
+ ```
81
+
82
+ ## 2. Prompt pertama (2 menit)
83
+
84
+ ```bash
85
+ minicode --work-mode BUILD "buat http server hello world di server.ts" --verbose
86
+ ```
87
+
88
+ 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).
89
+
90
+ Coba mode interaktif:
91
+
92
+ ```bash
93
+ minicode --interactive
94
+ # minicode › jelaskan isi src/tools/index.ts
95
+ # /model → picker provider::model, Enter = pilih + atur effort
96
+ # /status → token + biaya kumulatif sesi
97
+ # /exit → keluar (Esc ganda saat abort juga bisa)
98
+ ```
99
+
100
+ ## 3. Verify otomatis (2 menit)
101
+
102
+ ```bash
103
+ minicode --work-mode BUILD --verify "fix bugs lalu typecheck"
104
+ ```
105
+
106
+ Sebelum agen jalan, baseline diuji dulu. Bila baseline sudah merah, catatan Health-Check ditempel ke prompt awal agar agen memperbaiki dulu. Setelah run, verify dijalankan; bila gagal, agen self-heal maks 3 siklus. Output error dibungkus fence agar tidak jadi prompt injection. Custom command via `MINICODE_VERIFY_CMD` atau `verifyCommand` di config.
107
+
108
+ ## Contoh pola harian
109
+
110
+ ```bash
111
+ minicode --ask "deploy script" # human-in-loop confirmation card
112
+ minicode --sandbox docker "task" # bash di container ephemeral
113
+ minicode --budget 0.50 "task besar" # warn 80%; pagu lewat → prompt baru ditolak + turn berjalan digugurkan
114
+ minicode exec "prompt" --json # headless CI: JSONL stream + summary
115
+ minicode "/review src/a.ts" # skill slash-command
116
+ ```
117
+
53
118
  ## Matriks OS
54
119
 
55
120
  | OS | Sandbox otomatis | Default permission | Catatan |
@@ -80,7 +145,7 @@ One-shot, `exec`, pipe, dan CI hanya menampilkan notifikasi (tanpa install).
80
145
  > manual sesuai kebijakan organisasinya.
81
146
 
82
147
  ```bash
83
- npm install -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
148
+ bun add -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
84
149
  minicode sync # refresh model baru dari semua provider
85
150
  minicode pricing sync # refresh cache harga dari models.dev
86
151
  ```
@@ -100,5 +165,4 @@ Uninstall = `npm uninstall -g minicode-ai` (atau hapus clone + `bun unlink` bila
100
165
 
101
166
  ## Berikutnya
102
167
 
103
- - [Quickstart 5 menit](quickstart.md) — wizard → prompt pertama → verify.
104
168
  - [Troubleshooting](troubleshooting.md) — bila `doctor` merah atau sandbox tidak jalan.
package/docs/repl.md CHANGED
@@ -36,7 +36,7 @@ locale OS > en. `/lang` tanpa argumen = tampilkan aktif. Semua string lewat kamu
36
36
 
37
37
  Alias (jalan, tidak diiklankan di `/help`): `/models` → `/model`, `/providers` → `/provider`, `/usage` & `/cost` → `/status`, `/resume [id]` → `/sessions [id]`, `/compact`, `/thinking`, `/minimize`, `/quit`.
38
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).
39
+ Perintah tersembunyi (sengaja tak tampil di `/help`/dropdown, per-sesi): `/unrestric` — jembatan jail luar workspace + bash-guard + allowlist dibuka, kredensial git sempit diteruskan, tetapi file sensitif/state minicode tetap ditolak; gerbang = kepercayaan operator (toggle; footer menampilkan `○` merah). Detail di [Keamanan](security.md).
40
40
 
41
41
  Did-you-mean: typo `/sessoons` → `Did you mean /sessions?` (jarak ≤ 2).
42
42
 
package/docs/security.md CHANGED
@@ -2,11 +2,32 @@
2
2
 
3
3
  ## Prinsip
4
4
 
5
+ Minicode mengontrol **kemampuan bertingkat** (layered capability control), bukan niat model.
6
+ Model boleh salah paham; yang menentukan apa yang benar-benar terjadi adalah gerbang
7
+ deterministik di bawahnya: izin → jail → guard → validasi → eksekusi → bukti.
8
+
5
9
  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
10
  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
11
  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
12
  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
13
 
14
+ ## Execution Chain
15
+
16
+ Setiap pemanggilan tool melewati rantai ini, berurutan:
17
+
18
+ ```
19
+ Permission → Jail → Bash Guard → Argument Validation → Executor → Journal / Recovery
20
+ ```
21
+
22
+ | Tahap | Fungsi |
23
+ |---|---|
24
+ | **Permission** | Mode izin (`src/policy/permission.ts`) memutuskan allow/deny/ask per pasangan tool+args. Berlaku SEBELUM efek apa pun. |
25
+ | **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). |
26
+ | **Bash Guard** | Perintah shell dinormalisasi dulu (buang quote/wrapper/variabel sederhana), baru diperiksa polanya. Menolak env-dump, exfiltrasi upload, interpreter inline, destruksi luas. |
27
+ | **Argument Validation** | Skema argumen divalidasi kernel sebelum eksekusi; argumen invalid ditolak tanpa efek. |
28
+ | **Executor** | Menjalankan yang lolos: read paralel, write dibatasi konkurensinya, abort-aware, output dipotong dengan penanda (tak pernah diam-diam). |
29
+ | **Journal / Recovery** | Tiap mutasi dicatat sebagai `pending` lalu `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn durable. Resume tak pernah mengulang buta (lihat [Recovery](#recovery)). |
30
+
10
31
  ## Mode dan akses
11
32
 
12
33
  Kontrol mode punya tiga sumbu: **WorkMode** (`DISCUSS`/`PLAN`/`BUILD`) membatasi cara kerja agent; **PermissionMode** (`AUTO`/`ASK`) menentukan kapan dibutuhkan persetujuan manusia; **Tool Access Policy** menentukan capability yang tersedia. Nilai internal `readonly`, `plan`, `allowlist`, dan `allow-all` masih ada untuk batas akses dan kompatibilitas, tetapi bukan empat mode pengawasan tambahan. Hard deny path jail, owned-state, dan bash-guard tetap berlaku. Detail kombinasi dan interface ada di [Memilih Mode](choosing-mode.md) dan [Policy & Sandbox](policy-sandbox.md).
@@ -77,9 +98,35 @@ provider model pihak ketiga.
77
98
 
78
99
  Setiap turn checkpoint shadow-git + recovery journal `.minicode/journal-<sesi>.jsonl` (`pending` → `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn durable). Saat resume: `committed` yang turn-nya hilang tidak diulang; `pending`/`failed`/`unknown` → direktif verifikasi, dilarang redo buta; `committed` MCP = external-acknowledged wajib baca-balik. Detail di [Memory & Sessions](memory-sessions.md).
79
100
 
101
+ ## Dangerous Capabilities
102
+
103
+ Minicode **tidak menyediakan tool** untuk (terverifikasi di `src/tools/`):
104
+
105
+ - `git fetch`, `pull`, `clone` — tak ada tool git jaringan pembaca
106
+ - `git reset`, `amend`, `rebase`, `checkout`, `branch -D`, `stash drop`
107
+ - Eksekusi remote / deploy bawaan
108
+
109
+ Satu-satunya operasi jaringan git adalah `git_push` (di-gate seperti `git_commit`: TTY minta sekali, non-TTY tolak, `readonly/plan/allowlist` tolak, sub-agent tidak mendapatkannya). Tool ini memakai hardening `GIT_SAFE_BASE` dan di mode `unrestricted` mendapat kredensial git sempit (lihat §Mode dan akses).
110
+
111
+ Catatan jujur: operasi lain tetap BISA diketik lewat `bash` (tunduk pada bash-guard + jail, BUKAN larangan). `git` via bash menjalankan konfigurasi repo apa adanya (hook/filter/driver milik repo). Tool baca `git_*` dinetralkan; `git_push` menetralkan hook/filter via `GIT_SAFE_BASE`; `git_commit` menolak sebelum staging bila filter Git terkonfigurasi. Di repo tak-terpercaya, utamakan tool baca dan tinjau konfigurasi sebelum memakai Git manual.
112
+
113
+ ## Limitations
114
+
115
+ - **Repo hooks/filter/driver:** `git` via bash mengeksekusinya (semantik stock-git); tool baca `git_*` menetralkan filter, sedangkan `git_commit` menolak bila menemukan filter terkonfigurasi.
116
+ - **Bash arbitrer:** guard adalah analisis statis; substitusi dinamis (`$(curl …)`) butuh sandbox OS/docker untuk isolasi nyata.
117
+ - **Efek eksternal MCP:** setelah terjadi, tak bisa dibatalkan dari sini.
118
+ - **Provider/network:** data melewati provider pilihan Anda; Minicode tak menambahkan transmisi sendiri.
119
+ - **Perilaku model:** pemilihan tool, klaim sukses, dan kepatuhan intent adalah sifat model — orkestrasi menjamin bukti dan batas, bukan kebijaksanaan.
120
+ - **Server LSP:** di-spawn dari perintah di config Anda; hanya daftarkan server yang Anda percaya.
121
+ - **Repo tak-terpercaya:** perlakukan seperti menjalankan `git`/`bash` manual di sana — karena memang itu yang terjadi di balik tool.
122
+
123
+ ## Security Contact
124
+
125
+ 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`.
126
+
80
127
  ## Lanjut
81
128
 
82
- - [Security Model](security-model.md) — rantai eksekusi, trust boundary, dan limitasi dalam satu halaman.
129
+ - [Keamanan](security.md) — rantai eksekusi, trust boundary, dan limitasi dalam satu halaman.
83
130
  - [Policy & Sandbox](policy-sandbox.md) — mode, tool access policy, dan detail guard.
84
- - [Kontrak Terminal](terminal.md) — kenapa warna di-gate TTY.
131
+ - [Kontrak Terminal](TERMINAL_CONTRACT.md) — kenapa warna di-gate TTY.
85
132
  - [Otomasi & CI](exec.md) — batasan agent di CI (fail-closed non-TTY).
package/docs/tools.md CHANGED
@@ -66,7 +66,8 @@ Batas `BASH_BACKGROUND_MAX_JOBS`; semua job mati saat CLI keluar.
66
66
  | `git_status` | `status --porcelain + diff --stat + log -10` | cwd jail |
67
67
  | `git_diff` | `diff` unstaged atau `--staged` | — |
68
68
  | `git_log` | `log --oneline -n` | — |
69
- | `git_commit` | Commit saja | **Di-gate** seperti `delegate_task` (TTY = minta sekali, non-TTY = tolak; `readonly/plan/allowlist` = tolak). Menolak sebelum staging jika config Git efektif memuat custom filter; tinjau filter terpercaya lalu lakukan commit manual. Sub-agent tidak mendapatkannya. Yang sengaja tidak ada: push/amend/reset/rebase/checkout/branch -D/stash drop. Pesan via `-m` tunggal agar `$()`/backtick tidak dieksekusi; `git add -- <paths>` agar file `-weird.txt` tidak jadi flag |
69
+ | `git_commit` | Commit saja | **Di-gate** seperti `delegate_task` (TTY = minta sekali, non-TTY = tolak; `readonly/plan/allowlist` = tolak). Menolak sebelum staging jika config Git efektif memuat custom filter; tinjau filter terpercaya lalu lakukan commit manual. Sub-agent tidak mendapatkannya. Yang sengaja tidak ada: amend/reset/rebase/checkout/branch -D/stash drop. Pesan via `-m` tunggal agar `$()`/backtick tidak dieksekusi; `git add -- <paths>` agar file `-weird.txt` tidak jadi flag |
70
+ | `git_push` | Push branch lokal ke remote | **Di-gate** seperti `git_commit`; butuh branch/remote eksplisit atau `setUpstream`. Hardening `GIT_SAFE_BASE` menetralkan hook pre-push + filter repo. Di mode `unrestricted`, kredensial git sempit (`GH_TOKEN`/`GITHUB_TOKEN`/`SSH_AUTH_SOCK`) diteruskan ke subprocess; di mode lain push hanya berhasil bila kredensial sudah tersedia di mesin (mis. credential helper OS). Sub-agent tidak mendapatkannya |
70
71
 
71
72
  ## Web
72
73
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.23.0",
3
+ "version": "0.26.0",
4
4
  "description": "Open-source terminal coding agent on a vendored zero-dependency MiniCore kernel — layered permissions, path jail, sandboxing, MCP/LSP, and durable shadow-git checkpoints",
5
5
  "type": "module",
6
6
  "private": false,
@@ -51,41 +51,7 @@
51
51
  "scripts/vendor-overlays/minicode-context.patch",
52
52
  "README.md",
53
53
  "LICENSE",
54
- "docs/OUTPUT_EVENT_MODEL.md",
55
- "docs/OUTPUT_PROTOCOL_SPEC.md",
56
- "docs/OUTPUT_RENDERING_SPEC.md",
57
- "docs/OUTPUT_UX_RULES.md",
58
- "docs/P14_OPEN_WORK.md",
59
- "docs/SUMMARY.md",
60
- "docs/TERMINAL_CONTRACT.md",
61
- "docs/UI_RENDER_PIPELINE.md",
62
- "docs/agents.md",
63
- "docs/architecture.md",
64
- "docs/autonomous-scheduler.md",
65
- "docs/choosing-mode.md",
66
- "docs/cli.md",
67
- "docs/concepts.md",
68
- "docs/CONTROL-PLANE-MAP.md",
69
- "docs/config-providers.md",
70
- "docs/config.md",
71
- "docs/contributing.md",
72
- "docs/environment.md",
73
- "docs/exec.md",
74
- "docs/getting-started.md",
75
- "docs/glossary.md",
76
- "docs/mcp-lsp.md",
77
- "docs/memory-sessions.md",
78
- "docs/policy-sandbox.md",
79
- "docs/pricing-budget.md",
80
- "docs/quickstart.md",
81
- "docs/repl.md",
82
- "docs/security-model.md",
83
- "docs/security.md",
84
- "docs/skills.md",
85
- "docs/terminal.md",
86
- "docs/tools.md",
87
- "docs/troubleshooting.md",
88
- "docs/verify-benchmark.md"
54
+ "docs"
89
55
  ],
90
56
  "scripts": {
91
57
  "test": "bun test",
@@ -15,7 +15,7 @@ let currentConfig: MinicodeConfig | null = null
15
15
  * manusia ke stderr, `exec --json` menambah envelope mesin ke stdout.
16
16
  * Pesan = teks yang dulu dicetak langsung sebelum exit(1) — byte-identik. */
17
17
  export class NoProviderError extends Error {
18
- readonly name = "NoProviderError"
18
+ override readonly name = "NoProviderError"
19
19
  }
20
20
 
21
21
  const NO_PROVIDER_MESSAGE =