minicode-ai 0.9.26

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 (162) hide show
  1. package/CHANGELOG.md +935 -0
  2. package/LICENSE +21 -0
  3. package/README.md +200 -0
  4. package/cli/args.ts +195 -0
  5. package/cli/auto-update.ts +108 -0
  6. package/cli/commands/auth.ts +166 -0
  7. package/cli/commands/config.ts +382 -0
  8. package/cli/commands/doctor.ts +128 -0
  9. package/cli/commands/exec.ts +179 -0
  10. package/cli/commands/mcp.ts +35 -0
  11. package/cli/commands/memory.ts +107 -0
  12. package/cli/commands/pricing.ts +100 -0
  13. package/cli/commands/providers.ts +162 -0
  14. package/cli/commands/sessions.ts +128 -0
  15. package/cli/commands/skills.ts +61 -0
  16. package/cli/commands/stats.ts +82 -0
  17. package/cli/commands.ts +317 -0
  18. package/cli/index.ts +539 -0
  19. package/cli/model-manager.ts +112 -0
  20. package/cli/provider-manager.ts +111 -0
  21. package/cli/repl.ts +734 -0
  22. package/cli/router.ts +124 -0
  23. package/cli/setup.ts +780 -0
  24. package/cli/wizard.ts +21 -0
  25. package/docs/ARCHITECTURE.html +1222 -0
  26. package/docs/README.md +109 -0
  27. package/docs/architecture.md +44 -0
  28. package/docs/changelog.md +3 -0
  29. package/package.json +91 -0
  30. package/src/agents/pool.ts +43 -0
  31. package/src/app/mentions.ts +50 -0
  32. package/src/app/provider-layer.ts +118 -0
  33. package/src/app/rag-layer.ts +105 -0
  34. package/src/app/session.ts +154 -0
  35. package/src/app/tool-layer.ts +56 -0
  36. package/src/config.ts +372 -0
  37. package/src/constants.ts +119 -0
  38. package/src/hooks/run.ts +89 -0
  39. package/src/lib/atomic-write.ts +88 -0
  40. package/src/lib/db-path.ts +36 -0
  41. package/src/lib/git-hardening.ts +91 -0
  42. package/src/lib/ignore.ts +58 -0
  43. package/src/lib/keystore.ts +202 -0
  44. package/src/lib/net.ts +70 -0
  45. package/src/lib/safe-open.ts +138 -0
  46. package/src/lib/session-id.ts +23 -0
  47. package/src/lib/trash.ts +38 -0
  48. package/src/lib/trusted-exec.ts +81 -0
  49. package/src/lsp/client.ts +395 -0
  50. package/src/mcp/client.ts +400 -0
  51. package/src/mcp/http-transport.ts +344 -0
  52. package/src/mcp/server.ts +538 -0
  53. package/src/mcp/transport.ts +150 -0
  54. package/src/memory/files.ts +159 -0
  55. package/src/memory/vector.ts +775 -0
  56. package/src/policy/allowlist.ts +67 -0
  57. package/src/policy/bash-guard.ts +465 -0
  58. package/src/policy/compaction.ts +271 -0
  59. package/src/policy/context.ts +161 -0
  60. package/src/policy/executor.ts +199 -0
  61. package/src/policy/jail.ts +127 -0
  62. package/src/policy/permission.ts +517 -0
  63. package/src/policy/pricing.ts +336 -0
  64. package/src/policy/ratelimit.ts +54 -0
  65. package/src/policy/sandbox-policy.ts +157 -0
  66. package/src/policy/scrub.ts +138 -0
  67. package/src/policy/update-check.ts +200 -0
  68. package/src/policy/usage.ts +292 -0
  69. package/src/policy/verifier.ts +181 -0
  70. package/src/providers/anthropic.ts +401 -0
  71. package/src/providers/auth-store.ts +139 -0
  72. package/src/providers/build.ts +136 -0
  73. package/src/providers/detect.ts +126 -0
  74. package/src/providers/effort.ts +165 -0
  75. package/src/providers/guards.ts +107 -0
  76. package/src/providers/oauth.ts +326 -0
  77. package/src/providers/presets.ts +122 -0
  78. package/src/providers/provision.ts +298 -0
  79. package/src/providers/responses.ts +371 -0
  80. package/src/providers/router.ts +247 -0
  81. package/src/repo/repomap.ts +470 -0
  82. package/src/sandbox/docker.ts +129 -0
  83. package/src/sandbox/os.ts +193 -0
  84. package/src/session/checkpoint.ts +543 -0
  85. package/src/session/journal.ts +1347 -0
  86. package/src/session/persistence.ts +446 -0
  87. package/src/session/shadow-git.ts +351 -0
  88. package/src/session/turn-marker.ts +118 -0
  89. package/src/skills/loader.ts +117 -0
  90. package/src/telemetry/trace.ts +283 -0
  91. package/src/tools/ask_user.ts +54 -0
  92. package/src/tools/bash.ts +400 -0
  93. package/src/tools/code_run.ts +96 -0
  94. package/src/tools/delete_file.ts +31 -0
  95. package/src/tools/edit.ts +204 -0
  96. package/src/tools/git.ts +301 -0
  97. package/src/tools/glob.ts +90 -0
  98. package/src/tools/grep.ts +281 -0
  99. package/src/tools/hashline.ts +66 -0
  100. package/src/tools/index.ts +103 -0
  101. package/src/tools/lsp.ts +346 -0
  102. package/src/tools/mcp_call.ts +163 -0
  103. package/src/tools/memory.ts +144 -0
  104. package/src/tools/move_file.ts +47 -0
  105. package/src/tools/patch.ts +86 -0
  106. package/src/tools/read_file.ts +130 -0
  107. package/src/tools/read_image.ts +80 -0
  108. package/src/tools/submit_result.ts +49 -0
  109. package/src/tools/task.ts +346 -0
  110. package/src/tools/todo.ts +201 -0
  111. package/src/tools/web_fetch.ts +161 -0
  112. package/src/tools/web_search.ts +156 -0
  113. package/src/tools/write_file.ts +42 -0
  114. package/src/ui/approval/prompt.ts +76 -0
  115. package/src/ui/assistant/simple.ts +568 -0
  116. package/src/ui/assistant/turn-status.ts +303 -0
  117. package/src/ui/contract.ts +55 -0
  118. package/src/ui/footer.ts +105 -0
  119. package/src/ui/input/input.ts +805 -0
  120. package/src/ui/input/prompt-engine.ts +606 -0
  121. package/src/ui/render/collapse.ts +84 -0
  122. package/src/ui/render/detail.ts +24 -0
  123. package/src/ui/render/diff.ts +181 -0
  124. package/src/ui/render/errors.ts +239 -0
  125. package/src/ui/render/format.ts +54 -0
  126. package/src/ui/render/highlight.ts +294 -0
  127. package/src/ui/render/markdown.ts +120 -0
  128. package/src/ui/render/money.ts +12 -0
  129. package/src/ui/render/reasoning.ts +20 -0
  130. package/src/ui/render/sanitize.ts +80 -0
  131. package/src/ui/render/table.ts +88 -0
  132. package/src/ui/render/theme.ts +339 -0
  133. package/src/ui/render/width.ts +256 -0
  134. package/src/ui/render/wrap.ts +120 -0
  135. package/src/ui/runtime/bus-debug.ts +83 -0
  136. package/src/ui/runtime/chrome.ts +301 -0
  137. package/src/ui/runtime/spinner.ts +77 -0
  138. package/src/ui/runtime/statusline.ts +227 -0
  139. package/src/ui/screens/model-manager.ts +434 -0
  140. package/src/ui/screens/overlay.ts +61 -0
  141. package/src/ui/screens/picker.ts +307 -0
  142. package/src/ui/screens/provider-manager.ts +450 -0
  143. package/src/ui/screens/wizard.ts +132 -0
  144. package/vendor/minicore/VENDOR.md +29 -0
  145. package/vendor/minicore/package.json +21 -0
  146. package/vendor/minicore/src/core/budget.ts +26 -0
  147. package/vendor/minicore/src/core/compact.ts +76 -0
  148. package/vendor/minicore/src/core/errors.ts +60 -0
  149. package/vendor/minicore/src/core/events.ts +74 -0
  150. package/vendor/minicore/src/core/executor.ts +139 -0
  151. package/vendor/minicore/src/core/history.ts +32 -0
  152. package/vendor/minicore/src/core/index.ts +42 -0
  153. package/vendor/minicore/src/core/loop.ts +344 -0
  154. package/vendor/minicore/src/core/permission.ts +24 -0
  155. package/vendor/minicore/src/core/provider.ts +39 -0
  156. package/vendor/minicore/src/core/recovery.ts +34 -0
  157. package/vendor/minicore/src/core/session.ts +327 -0
  158. package/vendor/minicore/src/core/snapshot.ts +142 -0
  159. package/vendor/minicore/src/core/tokens.ts +111 -0
  160. package/vendor/minicore/src/core/tool.ts +118 -0
  161. package/vendor/minicore/src/core/types.ts +50 -0
  162. package/vendor/minicore/src/providers/openai-compat.ts +366 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 startupmini
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,200 @@
1
+ # Minicode
2
+
3
+ Coding agent built on **MiniCore** (kernel di-vendor ke `vendor/minicore`, seam additif `compactAsync` + `initialMessages` + `cwd`).
4
+
5
+ MiniCore = kernel runtime `STATE/MODEL/ACTION/LOOP` (inti di-freeze; satu-satunya patch = seam additif backward-compatible). Minicode = layer agencode: tools FS/bash/git/memory/todo/MCP/LSP, sub-agents, skills, hooks ask, CLI shell-first pure ANSI (output linier di scrollback, tanpa Ink/React), memory hybrid RAG, sessions sqlite, repo-map, verifier.
6
+
7
+ > Angka yang bisa dihitung mesin (jumlah test, tool, coverage) **tidak ditulis di sini** — jalankan `bun test`, `bun run gate:coverage`, atau lihat CI. Riwayat perubahan per versi ada di [CHANGELOG.md](CHANGELOG.md).
8
+
9
+ 📖 **Mulai dari [docs/](docs/)** — [Instalasi](docs/getting-started.md), [Quickstart](docs/quickstart.md), [Memilih Mode](docs/choosing-mode.md) · [docs/ARCHITECTURE.html](docs/ARCHITECTURE.html) untuk peta struktur repo.
10
+
11
+ ## Hubungan
12
+ ```
13
+ vendor/minicore (zero-dep — inti di-freeze; hanya seam additif `compactAsync` + `initialMessages` + `cwd` yang dibuka)
14
+ ↑ di-resolve lewat subpath imports `#minicore` (bukan dependency)
15
+ minicode (coding-agent — self-contained, tanpa sibling clone)
16
+ ├─ src/tools/ → Tool fs/bash/git/memory/todo/task/mcp/lsp + symlink jail defense-in-depth
17
+ ├─ src/agents/ → Pool concurrency 3 (sub-agent isolasi, abort-aware)
18
+ ├─ src/hooks/ → allowlist merge global+local atomic chmod600
19
+ ├─ src/policy/ → permission auto|ask|readonly|plan|allowlist|allow-all, bash-guard ternormalisasi,
20
+ │ sandbox-policy (OS-native otomatis), pricing, executor order-preserving
21
+ ├─ src/providers/ → openai-compat + anthropic + router fallback · OAuth device-code + auth-store
22
+ ├─ src/mcp/ → client stdio + Streamable HTTP/SSE (tools/resources/prompts) · server
23
+ ├─ src/lsp/ → client diagnostics/definition/references/hover/symbols (didClose cleanup)
24
+ ├─ src/session/ → persistence sqlite + checkpoint shadow-git (tree, O(delta), HEAD user utuh)
25
+ ├─ src/skills/ → loader recursive .minicode/skills/*.md ({{args}}/$ARGUMENTS, slug name)
26
+ ├─ src/ui/ → presentation layer mandiri: render (theme/markdown/highlight/diff/width),
27
+ │ input (askLine + prompt-engine), printer linier (tool call expanded),
28
+ │ approval prompt, screens (picker/wizard/managers) — tanpa impor core/#minicore
29
+ ├─ experiments/ → harness adversarial (fuzz bash, stress shadow-git, server MCP jahat)
30
+ ├─ docs/ → ARCHITECTURE.html (peta struktur hidup) · USAGE.md
31
+ └─ cli/ → REPL (tab completion, multiline, history, slash commands) + controller tipis
32
+ wizard/model-manager/provider-manager (logic config tetap di src/)
33
+ ```
34
+
35
+ ## Quickstart
36
+ ```bash
37
+ # 0. Bun dulu (butuh bun >= 1.0; sekali, tutup-buka terminal lagi):
38
+ # Windows: powershell -c "irm bun.sh/install.ps1 | iex" (atau npm i -g bun)
39
+ # macOS/Linux: curl -fsSL https://bun.sh/install | bash
40
+ # cek: bun --version -> 1.4.x
41
+
42
+ # 1. Minicode:
43
+ npm install -g minicode-ai
44
+ # bin: minicode
45
+
46
+ # sekarang jalan di mana aja:
47
+ minicode # mode chat interaktif + wizard setup pertama kali
48
+ minicode "buat http server" --verbose # sekali jalan
49
+ minicode auth login # login OAuth device-code bila provider mendukung (tanpa API key); lainnya via API key
50
+ minicode providers # daftar gateway (tanpa LLM)
51
+ minicode models --match gemini # cari model lintas provider
52
+ minicode sync # refresh model baru dari semua provider
53
+ ```
54
+
55
+ Kernel MiniCore di-vendor ke `vendor/minicore` (20 file, ~81 KB) sehingga repo ini self-contained. Sumber kebenaran tetap repo `minicore`; kontributor yang punya clone sibling `../minicore` menyinkronkan dengan `bun run vendor:minicore`, dan CI menjaga kesinkronan lewat `bun run vendor:check`.
56
+
57
+ Wizard & `/provider` (add: `[0] OpenAI` … `[14] Custom URL` — hanya label, tanpa URL) + `/model` (Enter = pilih `provider::model` + picker `default/low/medium/high` untuk thinking effort, tersimpan di provider dan berlaku sesi berikutnya; Esc = batal total) menyajikan preset gateway (OpenAI, Anthropic, OpenRouter, DeepSeek, OpenCode Zen, Google, Ollama, Qwen, Groq, dll), API Key ter-masking, auto-detect models, dan provider otomatis pindah saat pilih model beda provider (tanpa restart).
58
+
59
+ ```bash
60
+ minicode --interactive # REPL linier (agentic Unix shell, output di scrollback)
61
+ minicode --ask "deploy script" # human-in-loop confirmation card
62
+ minicode --verify "fix bugs lalu typecheck" # auto-verify + self-heal setelah run
63
+ minicode --sandbox docker "task" # eksekusi bash dalam container ephemeral
64
+ minicode --sandbox none "task" # matikan sandbox otomatis (opt-out sadar)
65
+ minicode --ratelimit 30 "task" # batasi request LLM (rpm)
66
+ minicode "/review src/a.ts" # skill slash-command
67
+ minicode exec "prompt" --json # headless CI (JSONL stream + summary)
68
+ bun test # offline/hermetic (live & docker di-skip)
69
+ bun run test:live # E2E live (butuh config + jaringan)
70
+ bun run bench:smoke # benchmark smoke (tanpa API key)
71
+ bun run audit:harness # 60 cek harness deterministik (tanpa API key)
72
+ bun experiments/bash-bypass-probe.ts # ukur postur denylist bash (0 bypass = lulus)
73
+ ```
74
+
75
+ ## Tools
76
+ FS `read_file`(**nomor baris + offset/limit** — file besar dibaca per bagian, realpath jail, secret-scrubbed) `write_file`(atomic tmp→rename, mkdir) `edit`(unique+atomic, fuzzy CRLF/spasi + hashline) `apply_patch`(search/replace multi-hunk) `move_file`(rename atomik + backup dest) `delete_file`(soft-delete ke `.trash/`) `read_image`(gambar → konteks model) · search `glob`({a,b}, cwd jail) `grep`(**ripgrep bila tersedia**, fallback walker internal) · exec `bash`(30s SIGTERM→SIGKILL, cwd jail, env kredensial di-strip, progres streaming, **`background:true`** + `bash_output`/`bash_kill`, sandbox docker/os optional, fail-closed via `MINICODE_SANDBOX_STRICT=1`) `code_run`(python/node tanpa shell, wajib sandbox) · git `git_status/diff/log`(cwd jail) **`git_commit`**(di-gate; tanpa push/amend/reset) · web `web_fetch`(SSRF guard + DNS pinning) `web_search`(Tavily/DDG) · memory `read/write/forget_memory` (hybrid RAG WAL) · plan **`todo_write`/`todo_read`** (+artifact `.minicode/plans/`) `submit_result` (hasil terstruktur) `ask_user` (gated, fail-closed) · agents `delegate_task` (isolasi, pool 3) · MCP `mcp_list` `mcp_call` **`mcp_read`** **`mcp_prompt`** (+dynamic `serverid.toolname`) · LSP `lsp_diagnostics/definition/references/hover/symbols/workspace_symbols`
77
+
78
+ Daftar pasti: `bun -e "import {allTools} from './src/tools/index.ts'; console.log(allTools.map(t=>t.name))"`
79
+
80
+ Catatan `grep`: `rg` dipakai otomatis bila ada di PATH. Paksa jalur fallback dengan `MINICODE_GREP_ENGINE=js`. Kedua jalur menerapkan jail + secret-scrub yang sama dan diuji memberi hasil identik.
81
+
82
+ Catatan `git_commit`: di-gate seperti `delegate_task` (persetujuan sekali di TTY, tolak di non-TTY). `push`/`amend`/`reset`/`rebase`/`checkout` **sengaja tidak disediakan** — sulit dibalikkan atau mempengaruhi remote. Pesan commit diteruskan sebagai argumen `-m`, jadi `$()` dan backtick di dalamnya tidak dieksekusi.
83
+
84
+ Catatan `mcp_read`/`mcp_prompt`: keduanya **di-gate** meski read-only, karena menarik konten dari server pihak ketiga langsung ke konteks model — itu jalur prompt-injection. Blob biner tidak ditumpahkan sebagai base64.
85
+
86
+ ## Autentikasi
87
+
88
+ Dua jalur:
89
+
90
+ ```bash
91
+ # 1. API key (seperti sebelumnya)
92
+ minicode config add --baseUrl https://api.openai.com/v1 --apiKey sk-…
93
+
94
+ # 2. OAuth device-code — tanpa API key, tanpa kartu kredit
95
+ minicode auth login # tampilkan kode, buka URL, tunggu persetujuan
96
+ minicode auth status # lihat kredensial + kapan kedaluwarsa
97
+ minicode auth logout <id>
98
+ ```
99
+
100
+ Token OAuth disimpan di `~/.minicode/auth.json` (chmod 600), **bukan** di `config.json` — config sering ikut ter-commit sementara token adalah rahasia berumur pendek. Refresh berjalan otomatis dengan margin 60 detik, jadi login sekali cukup. Provider OAuth yang belum login dibuang dari daftar dengan peringatan alih-alih mengirim header kosong.
101
+
102
+ ## Biaya & harga model
103
+
104
+ 25 harga bawaan tersedia offline. Untuk cakupan lebih luas, tarik sendiri:
105
+
106
+ ```bash
107
+ minicode pricing sync # 3.162 model dari models.dev (~213 KB cache)
108
+ minicode pricing status # sumber yang aktif + umur cache
109
+ minicode pricing show claude-sonnet-4-5
110
+ ```
111
+
112
+ **Tidak ada fetch otomatis** — jalur run biasa hanya membaca cache lokal. Request ke pihak ketiga saat startup menambah latensi dan membocorkan pola pemakaian tanpa diminta. Satu model id sering ditawarkan beberapa provider dengan harga berbeda (`qwen3-coder-plus` ada di 6 provider, dua di antaranya $0 karena paket berlangganan); overlay memakai **median** setelah membuang kandidat gratis, supaya `--budget` tidak diam-diam menganggap semuanya gratis.
113
+
114
+ ## Providers (hybrid x-api-key + Bearer)
115
+ OpenAI-compat (OpenAI/OpenRouter/Ollama/vLLM/DeepSeek), Anthropic streaming tool_use cap 30s max_tokens configurable, Router fallback rate_limit/server/network clone-error + C4 base64 fix + P2 retryAfter cap. Detect `GET /models` timeout 4s. Config global+local merge (local prioritas) atomic write + chmod 600. Build provider terpusat di `src/providers/build.ts`.
116
+
117
+ ## Policy & Memory
118
+ permission `auto|ask|readonly|plan|allowlist|allow-all` — bash guard **berbasis normalisasi** (`src/policy/bash-guard.ts`): quote pemisah kata dibuang dan assignment variabel sederhana disubstitusi **sebelum** pemeriksaan, jadi `cat .e""nv`, `X=.env; cat $X`, dan `p=python3; $p -c 1` tidak lagi lolos. Path jail sep-aware + **symlink realpath di permission layer**, `.env`/`.git/config`/`node_modules` deny; ask = allowlist glob merge global+local + TUI prompt persist. Mode bisa diganti runtime via Shift+Tab di TUI. Auto mode: `delegate_task`/`mcp_call`/**semua tool MCP bertitik** di-gate (prompt saat TTY, **tolak** tanpa TTY). Compaction: mekanikal sinkron default; **LLM async otomatis via seam kernel `compactAsync`**. Executor order-preserving: mixed step sequential, pure-read paralel, write di-cap, antrean abort-aware. Usage cost pricing longest-key **per-segment**. Sessions sqlite WAL capped + busy-retry, **persistence incremental** + placeholder binary. Vector hybrid WAL `0.7 cosine + 0.3 keyword`.
119
+
120
+ **Sandbox aktif otomatis.** Bila bubblewrap (Linux) atau seatbelt (macOS) tersedia, bash berjalan di dalamnya tanpa perlu flag. Bila tidak tersedia — termasuk **semua Windows** — permission default diturunkan ke `allowlist` dan alasannya dicetak sekali, karena lebih baik membatasi perintah daripada menjalankan apa pun sambil menampilkan label aman. Pilih sendiri dengan `--allow-all`/`--ask`, matikan dengan `--sandbox none`, atau pakai `--sandbox docker`.
121
+
122
+ Postur keamanan bash terukur, bukan diklaim — **dua lapis** (korpus manual + fuzz); exit 0 berarti 0 bypass dan 0 over-block:
123
+
124
+ ```bash
125
+ bun run gate:bash # korpus manual pola serangan + perintah sah
126
+ bun run extreme:fuzz # mutasi kombinatorial ber-seed
127
+ ```
128
+
129
+ Probe manual menguji serangan yang sudah dipikirkan; fuzz membangkitkan varian sendiri dari transformasi yang shell anggap setara (quote-split, indirection variabel, wrapper perintah, flag panjang, chaining). Temuan terkunci sebagai regression test (`test/bash-fuzz-regression.test.ts`); jalankan kedua lapis untuk angka terkini.
130
+
131
+ Batasnya tetap jujur: ini analisis statis, jadi command substitution dinamis (`$(...)`) tak bisa diselesaikan tanpa mengeksekusi — untuk itulah sandbox OS ada.
132
+
133
+ ## Security Layers
134
+ ```
135
+ PermissionHandler (bash-guard ternormalisasi + jail realpath + cwd) → validateArgs (kernel) → executor (order/cap/abort-aware) → tool realpath+atomic(O_EXCL) → execute
136
+ bash → sandbox OS-native otomatis (bwrap/seatbelt) bila tersedia; tanpa itu default permission = allowlist
137
+ spawn env → sanitizeSpawnEnv (strip kata-kunci kredensial di hasil merge final; GITHUB_WORKSPACE dsb TIDAK ikut terhapus)
138
+ config/allowlist → atomic randomUUID tmp+rename + chmod 600 · MCP serve curated tools + permission aktif
139
+ web_fetch → redirect manual ≤5 hop, DNS pinning per-hop, body hard-cap 2MB
140
+ ```
141
+
142
+ ## Skills
143
+ `.minicode/skills/**/*.md` (recursive) frontmatter `name/description` + body `{{args}}` atau `$ARGUMENTS`. Nama auto-slug (`My Skill`→`my-skill`). `minicode skills list/show`, prompt `/name args`.
144
+
145
+ ## Verification & Benchmark
146
+ - **Auto-verify** (`--verify`): deteksi command (`typecheck` → `test` → `tsconfig`) atau `MINICODE_VERIFY_CMD`; loop self-heal maks 3 siklus.
147
+ - **Checkpoint shadow-git**: snapshot per turn sebagai SHA tree git — O(delta), tanpa cap jumlah file, `HEAD`/index Anda tak pernah disentuh, ref menunjuk *tree* sehingga tak muncul di `git log`. `.gitignore` dihormati (jadi undo mencakup yang dilacak git). Non-repo memakai fallback snapshot file.
148
+ - **Repo-map**: simbol per file (regex, 9 bahasa) di-cache `.minicode/repomap.json`, disuntik ke system prompt. Tree-sitter sengaja tidak dipakai — alasan terukur di `extractSymbolsAsync`.
149
+ - **Secret scrubber**: `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` di-redact sebelum sampai ke LLM (read_file/bash/grep) — tanpa whitelist kata.
150
+ - **Telemetry**: `.minicode/traces.jsonl` — satu baris JSON per run (tokens, steps, cost, durasi); prompt di-scrub; **opt-out** `MINICODE_TELEMETRY=0`.
151
+ - **Benchmark**: `bun run bench` (butuh provider) / `bun run bench:smoke` (fake, untuk CI) → `bench/results.json` (resolve rate, steps, token, cost).
152
+
153
+ ## Aturan
154
+ - Jangan mengubah perilaku `vendor/minicore/src/core/*` — direktori itu hasil sync, bukan tempat mengedit. Satu-satunya pengecualian: seam **additif & backward-compatible** (mis. field opsional `compactAsync`, `initialMessages`, `cwd`) yang dibuka dari repo `minicore` lalu di-sync ulang. Kalau butuh primitive baru, buktikan dulu tidak bisa sebagai Tool/Provider/Policy.
155
+ - P2/C4/C5 sisa minicore ditangani di sini sebagai policy/adapter agencode, bukan patch core.
156
+
157
+ ## Pengujian
158
+
159
+ ```bash
160
+ bun install # sekali (butuh bun >= 1.0; tanpa clone tambahan)
161
+ bun test # offline/hermetic; live & docker di-skip otomatis
162
+ bun test test/ssrf-guard.test.ts # satu file spesifik
163
+ bun run typecheck # tsc --noEmit (strict) — mencakup src cli test bench scripts
164
+ bun run lint # biome check
165
+ bun run gate:coverage # gate coverage agregat (baris "All files")
166
+ bun run gate:bash # korpus serangan bash (0 bypass / 0 over-block)
167
+ bun run gate:pack # gate tarball npm (graf import, rahasia, ukuran)
168
+ bun run vendor:check # pastikan vendor/minicore sinkron dengan ../minicore
169
+ bun run extreme # tiga harness adversarial sekaligus
170
+ bun run bench:smoke # benchmark fake (tanpa API key, CI-safe)
171
+ MINICODE_GREP_ENGINE=js bun test test/phase1-tools.test.ts # paksa jalur grep fallback
172
+ ```
173
+
174
+ Eksperimen adversarial terpisah bila ingin fokus:
175
+
176
+ ```bash
177
+ bun run extreme:fuzz # fuzz bash-guard (--seed N untuk reproduksi)
178
+ bun run extreme:git # stress shadow-git (--files N --sessions N)
179
+ bun run extreme:mcp # server MCP jahat (hang, flood, redirect, SSRF)
180
+ ```
181
+
182
+ Test **live** (jaringan + provider ber-API-key):
183
+
184
+ ```bash
185
+ MINICODE_LIVE=1 bun run test:live # E2E end-to-end via LLM sungguhan
186
+ bun run bench # resolve-rate nyata (butuh config provider)
187
+ bun run test:qa # QA fitur live ke layar
188
+ ```
189
+
190
+ Catatan lingkungan:
191
+ - `bun:sqlite` dipakai langsung → **wajib Bun**, tidak jalan di Node.js.
192
+ - Test symlink di-skip otomatis tanpa privilege; test Docker di-skip bila daemon tidak jalan.
193
+ - Semua test default **hermetic/offline** — fetch di-mock, DB pakai tmpdir, tanpa API key.
194
+ - `rg` opsional. Tanpa `rg`, `grep` memakai walker internal dengan hasil identik.
195
+
196
+ ## Lisensi
197
+
198
+ **MIT License.** Bebas pakai, modifikasi, distribusi — lihat [LICENSE](LICENSE). Copyright (c) 2026 startupmini.
199
+
200
+ Lihat `docs/ARCHITECTURE.html` + `docs/HARNESS.md` + `PLAN.md`.
package/cli/args.ts ADDED
@@ -0,0 +1,195 @@
1
+ // Pure arg-parsing helpers - dipisah dari cli/index.ts agar mudah diuji.
2
+ const BOOLEAN_FLAGS = new Set([
3
+ "--verbose",
4
+ "--allow-all",
5
+ "--ask",
6
+ "--plan",
7
+ "--interactive",
8
+ "--verify",
9
+ "--allowlist",
10
+ "--json", // dipakai `exec --json` dan `--help --json`
11
+ "--budget-strict", // penegasan eksplisit fail-closed (kini juga default --budget)
12
+ "--allow-local-config", // opt-in: baca .minicode/config.json + allowlist lokal (default mati)
13
+ ])
14
+ const VALUE_FLAGS = new Set([
15
+ "--cwd",
16
+ "--resume",
17
+ "--model",
18
+ "--provider",
19
+ "--session",
20
+ "--max-steps",
21
+ "--context-window",
22
+ "--timeout",
23
+ "--sandbox",
24
+ "--ratelimit",
25
+ "--budget",
26
+ "--tool-scope", // full | explore (read-only) — tanpa ini jadi kata prompt!
27
+ "--output-format", // `exec --output-format=json`
28
+ "--prompt",
29
+ // subcommand flags — harus dikenal agar tidak bocor ke prompt one-shot
30
+ "--baseUrl",
31
+ "--apiKey",
32
+ "--id",
33
+ "--command",
34
+ "--args",
35
+ "--env",
36
+ "--header",
37
+ "--allow-private",
38
+ "--url",
39
+ "--match",
40
+ "--jsonl",
41
+ "--all-tools",
42
+ "--global",
43
+ "--local",
44
+ ])
45
+ export const valueFlags = VALUE_FLAGS
46
+ const KNOWN_FLAGS = new Set([...BOOLEAN_FLAGS, ...VALUE_FLAGS, "-h", "--help", "-v", "--version"])
47
+
48
+ /** `--flag` atau `--flag=value` -> normalisasi ke nama flag murni. */
49
+ export function flagNameOf(token: string): string | null {
50
+ if (!token.startsWith("-")) return null
51
+ const eq = token.indexOf("=")
52
+ const name = eq === -1 ? token : token.slice(0, eq)
53
+ return KNOWN_FLAGS.has(name) ? name : null
54
+ }
55
+
56
+ export function hasFlag(argv: string[], name: string): boolean {
57
+ for (let i = 0; i < argv.length; i++) {
58
+ const token = argv[i]
59
+ if (!token) continue
60
+ if (token === "--") return false
61
+ const flag = flagNameOf(token)
62
+ if (flag) {
63
+ if (token === name || token.startsWith(`${name}=`)) return true
64
+ if (valueFlags.has(flag) && !token.includes("=")) i++
65
+ continue
66
+ }
67
+ if (token.startsWith("-")) {
68
+ // unknown flag seperti "-5" untuk nilai numerik sudah di-skip sebagai value di atas
69
+ // bila sampai sini, itu prompt atau flag tak dikenal -> hentikan scan
70
+ if (/^-?\d+(\.\d+)?$/.test(token)) {
71
+ // "-5" tanpa flag sebelumnya bukan flag, anggap prompt
72
+ return false
73
+ }
74
+ // unknown flag -> prompt boundary, bukan flag global
75
+ return false
76
+ }
77
+ // prompt word pertama -> sisa argv adalah prompt, bukan flag
78
+ return false
79
+ }
80
+ return false
81
+ }
82
+
83
+ /** Opt-in config lokal untuk alur sesi utama (index/exec): flag eksplisit
84
+ * operator ATAU env (keduanya default mati). Memakai hasFlag yang
85
+ * boundary-aware: flag di DALAM teks prompt tidak dihitung (anti-injeksi).
86
+ * Handler subcommand (config/providers/…) memakai args.includes langsung
87
+ * karena argv-nya selalu diawali positional subcommand. */
88
+ export function allowLocalConfig(argv: string[]): boolean {
89
+ return hasFlag(argv, "--allow-local-config") || process.env.MINICODE_ALLOW_LOCAL_CONFIG === "1"
90
+ }
91
+
92
+ export function getArg(argv: string[], name: string): string | undefined {
93
+ // dukung bentuk --name value DAN --name=value; ambil kemunculan terakhir
94
+ // (flag berulang -> yang terakhir menang, konsisten dengan CLI umum)
95
+ let found: string | undefined
96
+ for (let i = 0; i < argv.length; i++) {
97
+ const a = argv[i]
98
+ if (a === undefined) break
99
+ if (a === "--") break
100
+ const flag = flagNameOf(a)
101
+ if (flag) {
102
+ if (a === name) {
103
+ const v = argv[i + 1]
104
+ if (v !== undefined && (v === "-" || !v.startsWith("-") || /^-?\d+(\.\d+)?$/.test(v)))
105
+ found = v
106
+ if (valueFlags.has(flag) && !a.includes("=")) i++
107
+ continue
108
+ } else if (a.startsWith(`${name}=`)) {
109
+ const v = a.slice(name.length + 1)
110
+ if (v !== "") found = v
111
+ continue
112
+ }
113
+ if (valueFlags.has(flag) && !a.includes("=")) i++
114
+ continue
115
+ }
116
+ if (a.startsWith("-")) {
117
+ if (/^-?\d+(\.\d+)?$/.test(a)) return found
118
+ return found
119
+ }
120
+ // prompt word pertama -> hentikan scan, sisa adalah prompt
121
+ return found
122
+ }
123
+ return found
124
+ }
125
+
126
+ export function promptFromArgs(argv: string[]): string {
127
+ const out: string[] = []
128
+ let afterSeparator = false
129
+ let seenPrompt = false
130
+ for (let i = 0; i < argv.length; i++) {
131
+ const a = argv[i]
132
+ if (a === undefined) break
133
+ if (a === "--") {
134
+ afterSeparator = true
135
+ continue
136
+ }
137
+ if (afterSeparator) {
138
+ out.push(a)
139
+ continue
140
+ }
141
+ const fname = flagNameOf(a)
142
+ if (fname === null) {
143
+ // bukan flag dikenal -> prompt word; setelah ini semua token jadi prompt
144
+ seenPrompt = true
145
+ out.push(a)
146
+ continue
147
+ }
148
+ if (seenPrompt) {
149
+ // flag dikenal setelah prompt pertama -> anggap bagian prompt (anti injection)
150
+ out.push(a)
151
+ // untuk value flag dengan "=" sudah push sebagai satu token prompt
152
+ // untuk bentuk terpisah, nilai berikutnya juga prompt jika ada
153
+ if (valueFlags.has(fname) && !a.includes("=")) {
154
+ const v = argv[i + 1]
155
+ if (v !== undefined) {
156
+ out.push(v)
157
+ i++
158
+ }
159
+ }
160
+ continue
161
+ }
162
+ if (BOOLEAN_FLAGS.has(fname)) continue
163
+ // value flag sebelum prompt: lewati flag + nilainya
164
+ if (!a.includes("=")) i++
165
+ }
166
+ return out.join(" ")
167
+ }
168
+
169
+ export function readPrompt(): Promise<string> {
170
+ if (process.stdin.isTTY) return Promise.resolve("")
171
+ return new Promise((resolve) => {
172
+ let data = ""
173
+ let done = false
174
+ const t = setTimeout(() => {
175
+ if (!done) {
176
+ done = true
177
+ resolve("")
178
+ }
179
+ }, 500)
180
+ process.stdin.setEncoding("utf8")
181
+ process.stdin.on("data", (c) => (data += c))
182
+ process.stdin.on("end", () => {
183
+ if (!done) {
184
+ done = true
185
+ clearTimeout(t)
186
+ resolve(data.trim())
187
+ }
188
+ })
189
+ // if stdin already ended
190
+ if (process.stdin.readableEnded) {
191
+ clearTimeout(t)
192
+ resolve("")
193
+ }
194
+ })
195
+ }
@@ -0,0 +1,108 @@
1
+ // Orkestrasi auto-update interaktif: cek → install → restart.
2
+ // Dipanggil dari cli/index.ts HANYA saat masuk REPL (enterRepl). One-shot,
3
+ // exec, pipe, dan CI tidak tersentuh (notifikasi async biasa) — restart di
4
+ // tengah pipeline akan merusak output machine dan perilaku skrip.
5
+
6
+ import { type ChildProcess, spawn } from "node:child_process"
7
+ import {
8
+ checkForUpdateFresh,
9
+ formatUpdateMessage,
10
+ installUpdate,
11
+ isInstalledCopy,
12
+ shouldAutoUpdate,
13
+ UPDATE_GUARD_ENV,
14
+ } from "../src/policy/update-check.ts"
15
+ import { c } from "../src/ui/render/theme.ts"
16
+
17
+ /**
18
+ * Tunggu proses anak sampai benar-benar selesai — SATU-SATUNYA cara menunggu
19
+ * spawn di repo ini. Dengarkan `exit` DAN `close` DAN `error`: `exit` saja
20
+ * tak datang bila anak menahan stdio (pipe inherit macet) sehingga induk
21
+ * menunggu selamanya tanpa umpan balik = terlihat hang. Guard `settled`
22
+ * karena exit+close bisa datang berurutan untuk anak yang sama.
23
+ */
24
+ export function waitChildExit(child: ChildProcess): Promise<number | null> {
25
+ return new Promise<number | null>((res) => {
26
+ let settled = false
27
+ const done = (c2: number | null) => {
28
+ if (settled) return
29
+ settled = true
30
+ res(c2)
31
+ }
32
+ child.on("exit", (c2) => done(c2))
33
+ child.on("close", (c2) => done(c2))
34
+ child.on("error", () => done(1))
35
+ })
36
+ }
37
+
38
+ /**
39
+ * Bila layak: cek registry (fresh), install bila ada versi baru, lalu
40
+ * respawn argv yang sama dan JANGAN kembali (process.exit di dalam).
41
+ * Return bila tidak ada update / tak layak / install gagal — REPL lanjut
42
+ * dengan versi lama. Tak pernah melempar.
43
+ */
44
+ export async function maybeAutoUpdate(
45
+ version: string,
46
+ signal?: AbortSignal,
47
+ opts?: { onLongOp?: () => void },
48
+ ): Promise<void> {
49
+ let decision: ReturnType<typeof shouldAutoUpdate>
50
+ try {
51
+ decision = shouldAutoUpdate(process.argv.slice(2), {
52
+ stdinTTY: process.stdin.isTTY,
53
+ installed: isInstalledCopy(),
54
+ })
55
+ } catch {
56
+ return
57
+ }
58
+ if (!decision.run) return
59
+ if (signal?.aborted) return
60
+ let latest: string | null
61
+ try {
62
+ latest = await checkForUpdateFresh(version, signal)
63
+ } catch {
64
+ return
65
+ }
66
+ if (signal?.aborted) return
67
+ if (!latest) return
68
+ // Fase panjang dimulai (install + restart): minta pemanggil mematikan
69
+ // spinner transient-nya DULU. Tanpa ini interval induk (80ms di
70
+ // cli/index.ts) terus menulis `\r\x1b[2K` ke stderr yang sama dengan anak
71
+ // (`stdio: inherit`) selama SELURUH sesi anak — output hancur/flicker dan
72
+ // terlihat hang di Windows Terminal.
73
+ try {
74
+ opts?.onLongOp?.()
75
+ } catch {}
76
+ process.stderr.write(`\n${c.yellow(formatUpdateMessage(version, latest))}\n`)
77
+ process.stderr.write(c.dim("Menginstall pembaruan otomatis…\n"))
78
+ let ok = false
79
+ try {
80
+ ok = installUpdate()
81
+ } catch {
82
+ ok = false
83
+ }
84
+ if (!ok) {
85
+ process.stderr.write(
86
+ c.yellow(
87
+ `Auto-update gagal — lanjut versi ${version}. Update manual: npm update -g minicode-ai\n`,
88
+ ),
89
+ )
90
+ return
91
+ }
92
+ // Restart ke kode baru dengan argv identik; guard env cegah loop bila
93
+ // versi ter-install ternyata masih dilaporkan lebih tua.
94
+ process.stderr.write(c.dim(`Restart ke versi ${latest}…\n`))
95
+ // Pastikan spinner induk mati sebelum anak hidup (idempoten — onLongOp
96
+ // sudah dipanggil sebelum install, tapi install bisa gagal-skip jalur ini
97
+ // bila dipanggil ulang di masa depan).
98
+ try {
99
+ opts?.onLongOp?.()
100
+ } catch {}
101
+ const entry = process.argv[1] ?? ""
102
+ const child = spawn(process.execPath, [entry, ...process.argv.slice(2)], {
103
+ stdio: "inherit",
104
+ env: { ...process.env, [UPDATE_GUARD_ENV]: "1" },
105
+ })
106
+ const code = await waitChildExit(child)
107
+ process.exit(code ?? 0)
108
+ }