minicode-ai 0.14.1 → 0.14.4
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.
- package/README.md +34 -178
- package/cli/args.ts +10 -18
- package/cli/auto-update.ts +32 -2
- package/cli/commands/acp.ts +20 -27
- package/cli/commands/daemon.ts +6 -7
- package/cli/commands/exec.ts +12 -10
- package/cli/commands.ts +6 -9
- package/cli/index.ts +40 -17
- package/cli/provider-manager.ts +1 -3
- package/cli/setup.ts +174 -145
- package/cli/tui.ts +33 -38
- package/docs/CONTROL-PLANE-MAP.md +145 -0
- package/docs/OUTPUT_EVENT_MODEL.md +1 -1
- package/docs/OUTPUT_PROTOCOL_SPEC.md +8 -2
- package/docs/OUTPUT_RENDERING_SPEC.md +35 -6
- package/docs/OUTPUT_UX_RULES.md +1 -1
- package/docs/README.md +14 -102
- package/docs/SUMMARY.md +53 -0
- package/docs/TERMINAL_CONTRACT.md +136 -77
- package/docs/UI_RENDER_PIPELINE.md +204 -0
- package/docs/agents.md +5 -5
- package/docs/architecture.md +23 -12
- package/docs/choosing-mode.md +7 -7
- package/docs/cli.md +22 -29
- package/docs/concepts.md +1 -1
- package/docs/config.md +10 -5
- package/docs/contributing.md +6 -6
- package/docs/environment.md +3 -1
- package/docs/exec.md +5 -5
- package/docs/getting-started.md +14 -12
- package/docs/glossary.md +9 -7
- package/docs/mcp-lsp.md +1 -1
- package/docs/memory-sessions.md +7 -5
- package/docs/policy-sandbox.md +23 -15
- package/docs/quickstart.md +2 -2
- package/docs/repl.md +4 -3
- package/docs/security-model.md +16 -17
- package/docs/security.md +15 -30
- package/docs/skills.md +1 -1
- package/docs/tools.md +6 -6
- package/docs/verify-benchmark.md +16 -0
- package/package.json +5 -5
- package/scripts/vendor-overlays/minicode-context.patch +109 -0
- package/src/app/mentions.ts +4 -3
- package/src/app/provider-layer.ts +13 -1
- package/src/app/session.ts +229 -22
- package/src/app/tool-layer.ts +6 -0
- package/src/config.ts +30 -3
- package/src/constants.ts +19 -0
- package/src/daemon/control.ts +1 -1
- package/src/lib/git-hardening.ts +27 -22
- package/src/lib/safe-open.ts +73 -19
- package/src/lib/trusted-exec.ts +7 -4
- package/src/mcp/client.ts +34 -9
- package/src/mcp/server.ts +2 -3
- package/src/mcp/transport.ts +96 -42
- package/src/memory/files.ts +15 -4
- package/src/memory/vector.ts +5 -1
- package/src/policy/compaction.ts +272 -16
- package/src/policy/context-window.ts +73 -0
- package/src/policy/context.ts +76 -16
- package/src/policy/ratelimit.ts +47 -18
- package/src/policy/tool-contract.ts +4 -10
- package/src/policy/update-check.ts +83 -6
- package/src/policy/usage.ts +31 -14
- package/src/policy/work-mode.ts +1 -1
- package/src/presentation/adapter.ts +64 -2
- package/src/presentation/events.ts +6 -0
- package/src/presentation/model.ts +1 -0
- package/src/presentation/projection.ts +2 -0
- package/src/presentation/reducer.ts +1 -0
- package/src/providers/anthropic.ts +52 -19
- package/src/providers/guards.ts +158 -16
- package/src/providers/provision.ts +12 -3
- package/src/providers/responses.ts +61 -23
- package/src/providers/router.ts +56 -23
- package/src/providers/sse-bounds.ts +170 -0
- package/src/repo/repomap.ts +10 -11
- package/src/runtime/execution-backend.ts +7 -8
- package/src/sandbox/docker.ts +113 -9
- package/src/session/checkpoint.ts +9 -2
- package/src/session/context-projection.ts +14 -0
- package/src/session/context-selector.ts +58 -20
- package/src/session/persistence.ts +6 -3
- package/src/session/verification.ts +55 -16
- package/src/skills/loader.ts +16 -3
- package/src/task/model.ts +21 -70
- package/src/tools/bash.ts +6 -3
- package/src/tools/code_run.ts +6 -5
- package/src/tools/context.ts +8 -0
- package/src/tools/delete_file.ts +2 -1
- package/src/tools/edit.ts +2 -1
- package/src/tools/git.ts +128 -54
- package/src/tools/glob.ts +2 -1
- package/src/tools/grep.ts +31 -6
- package/src/tools/lsp.ts +5 -4
- package/src/tools/mcp_call.ts +3 -1
- package/src/tools/memory.ts +175 -180
- package/src/tools/move_file.ts +2 -1
- package/src/tools/patch.ts +2 -1
- package/src/tools/read_file.ts +94 -1
- package/src/tools/read_image.ts +2 -1
- package/src/tools/task.ts +9 -1
- package/src/tools/todo.ts +4 -5
- package/src/tools/web_fetch.ts +28 -12
- package/src/tools/web_search.ts +28 -9
- package/src/tools/write_file.ts +2 -1
- package/src/ui/assistant/simple.ts +72 -3
- package/src/ui/footer.ts +131 -66
- package/src/ui/i18n/en.ts +3 -11
- package/src/ui/i18n/id.ts +3 -11
- package/src/ui/input/input.ts +2 -3
- package/src/ui/input/prompt-engine.ts +2 -5
- package/src/ui/render/width.ts +107 -79
- package/src/ui/runtime/screen.ts +49 -37
- package/src/ui/screens/model-manager.ts +3 -10
- package/src/ui/screens/picker.ts +23 -40
- package/src/ui/screens/provider-manager.ts +12 -33
- package/src/ui/screens/wizard.ts +0 -1
- package/src/ui/tui/app.ts +265 -211
- package/src/ui/tui/transcript.ts +87 -8
- package/vendor/minicore/VENDOR.md +9 -5
- package/vendor/minicore/src/core/loop.ts +47 -12
- package/vendor/minicore/src/core/provider.ts +4 -0
- package/vendor/minicore/src/core/session.ts +14 -1
- package/CHANGELOG.md +0 -1185
- package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
- package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
- package/docs/PLAN_UIUX_V6.md +0 -209
- package/docs/changelog.md +0 -3
package/docs/architecture.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Arsitektur
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Dokumen ini adalah peta struktur dan alur runtime yang aktif untuk kontributor.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Roadmap fase pemilik tidak tersedia di checkout ini; jangan simpulkan status fase atau next action dari changelog maupun kode. `TERMINAL_CONTRACT.md` adalah kontrak terminal FROZEN — baca sebelum mengubah output; perubahan perilaku memerlukan pembaruan kontrak dan peta test. Kontrak output aktif ada di [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), dan [UX rules](OUTPUT_UX_RULES.md). Peta alur rendering ada di [UI Render Pipeline](UI_RENDER_PIPELINE.md).
|
|
6
6
|
|
|
7
7
|
## Tiga lapisan
|
|
8
8
|
|
|
@@ -12,6 +12,13 @@ L2 src/ non-ui → agen: tools, agents, hooks, policy, providers, mcp, lsp,
|
|
|
12
12
|
L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (freeze, zero-dep, via #minicore)
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
+
Pin source kernel ada di [catatan vendor MiniCore](https://github.com/startupmini/minicode/blob/main/vendor/minicore/VENDOR.md):
|
|
16
|
+
`0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
|
|
17
|
+
|
|
18
|
+
Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
|
|
19
|
+
diterapkan saat sinkronisasi vendor; `VENDOR.md` mem-pin source, overlay, dan
|
|
20
|
+
fingerprint hasil akhirnya.
|
|
21
|
+
|
|
15
22
|
- `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
|
|
16
23
|
- Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
|
|
17
24
|
- DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `createProviderLayer → loadLastModel → createRagLayer → resume presentation-events + planRecovery + reconcileUndoRedo → setupToolLayer + setAskTextFn → createMinicodeSession → journal + checkpoint + semantic event sink + step-trace + runPromptWithVerify (baseline-first + self-heal 3 siklus + hooks) → logger + turn-status + usage/pricing → persist/finalize → close (kill jobs, mcp/lsp close)`. `setSubAgentSessionFactory` sebelum dispatch agar TUI/one-shot/`mcp serve` tercakup.
|
|
@@ -29,13 +36,16 @@ dutinya:
|
|
|
29
36
|
| Lapis | Isi | Authoritatif untuk |
|
|
30
37
|
|---|---|---|
|
|
31
38
|
| Kernel `ContextStore` | history yang dikirim ke model, bisa lossy saat kompaksi | window berjalan |
|
|
32
|
-
| Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error
|
|
33
|
-
| Vektor memory + `presentation_events` | ringkasan
|
|
39
|
+
| Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error`; dapat diganti saat shrink kompaksi | continuity/resume dari bentuk tersimpan saat ini |
|
|
40
|
+
| Vektor memory + `presentation_events` | ringkasan memory best-effort dan event semantik terpilih | RAG & audit UI; bukan salinan lengkap percakapan |
|
|
34
41
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
42
|
+
Kompaksi bersifat lossy, termasuk setelah restart. `persistCurrent` mengirim
|
|
43
|
+
history yang sudah dipadatkan ke `shrinkThreadHistory`, yang menghapus lalu
|
|
44
|
+
menulis ulang baris `messages`; model mekanis juga meringkas pesan lama dan
|
|
45
|
+
menghilangkan hasil tool yang sukses. Ringkasan ke vector memory hanya dibuat
|
|
46
|
+
di jalur LLM, dibatasi, opt-out, dan best-effort. Karena itu jangan menganggap
|
|
47
|
+
semua fakta lama tetap dapat dipulihkan dari sesi atau vector store; state
|
|
48
|
+
penting harus dicatat di task, file, atau artefak verifikasi yang otoritatif.
|
|
39
49
|
|
|
40
50
|
Fidelity resume: `reasoning` (thinking) dan `is_error` (tool gagal) adalah
|
|
41
51
|
field kernel `Message` yang ikut dibawa ke history. Semula keduanya tidak punya
|
|
@@ -82,8 +92,7 @@ Tiga aturan yang menjaga domain ini:
|
|
|
82
92
|
bisa berbeda arah — dan plan event terbit di `execution:completed`, bukan
|
|
83
93
|
dari argumen sebelum tool jalan.
|
|
84
94
|
|
|
85
|
-
Batas subsystem **todo
|
|
86
|
-
audit historisnya): file todo tetap datar — tanpa field dependency di
|
|
95
|
+
Batas subsystem **todo**: file todo tetap datar — tanpa field dependency di
|
|
87
96
|
`TodoItem`, tanpa surface user (`/tasks`), `/undo` hanya revert file (todo
|
|
88
97
|
tetap `completed`), dan tanpa TTL/GC untuk file todo di luar SQLite.
|
|
89
98
|
Dependency/graph dan scheduler **sudah ada**, tetapi pada subsystem terpisah:
|
|
@@ -112,15 +121,17 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
|
|
|
112
121
|
|
|
113
122
|
Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
|
|
114
123
|
|
|
115
|
-
Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris `✦ 00.00.00
|
|
124
|
+
Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `✗ pesan actionable` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
|
|
116
125
|
|
|
117
126
|
## Modul kunci
|
|
118
127
|
|
|
119
128
|
- `src/session/verification.ts` + `src/tools/evidence.ts`: identitas invokasi milik aplikasi, intent/receipt yang di-await, observasi eksplisit, idempotency, dan korelasi efek anak — semuanya di jurnal mutasi yang sama.
|
|
120
129
|
|
|
121
130
|
- `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
|
|
122
|
-
- `src/presentation/`: `events.ts`
|
|
131
|
+
- `src/presentation/`: `events.ts` mendefinisikan event presentasi dan registry durability; `adapter.ts` memetakan runtime ke `DomainEvent`; `reducer.ts`/`model.ts` membangun state replayable dan ringkasan turunan; `store.ts` menyimpan referensi konten; `projection.ts` membentuk envelope `minicode.output.v1` dan kategori error machine. `src/session/persistence.ts` menyimpan log `presentation_events` dan `messages` dengan fidelity `reasoning`/`is_error`. `cli/setup.ts` memiliki bridge exhaustive `toPresentationEvent()`; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy`.
|
|
123
132
|
- `src/ui/input/`: `askLine`, `prompt-engine` (grapheme `Intl.Segmenter`, streaming decoder, bracket-paste, mouse X10/SGR press/drag/release + wheel dinormalisasi; selection app-level di TUI).
|
|
124
133
|
- `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
|
|
125
134
|
- `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
|
|
135
|
+
- `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
|
|
136
|
+
- `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
|
|
126
137
|
- Kualitas: `bench/`, `scripts/` (coverage/pack/telemetry/vendor), `experiments/` (adversarial).
|
package/docs/choosing-mode.md
CHANGED
|
@@ -12,16 +12,16 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
12
12
|
|
|
13
13
|
| Saya ingin… | Gunakan | Karena |
|
|
14
14
|
|---|---|---|
|
|
15
|
-
| Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal
|
|
16
|
-
| Minta agen membuat perubahan |
|
|
17
|
-
| Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
|
|
15
|
+
| Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal; network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
|
|
16
|
+
| Minta agen membuat perubahan | `--work-mode BUILD` + `AUTO` (Permission Mode default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
|
|
17
|
+
| Menyetujui setiap perubahan | `--work-mode BUILD --ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
|
|
18
18
|
| Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
|
|
19
|
-
| Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
|
|
20
|
-
| Otonom penuh di mesin sendiri | `
|
|
19
|
+
| Otomasi/CI tanpa manusia | One-shot/`exec` + default `DISCUSS` untuk baca; tambah `--work-mode BUILD` bila perlu mutasi | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
|
|
20
|
+
| Otonom penuh di mesin sendiri | `--work-mode BUILD` + `AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
|
|
21
21
|
|
|
22
22
|
## Rule of thumb
|
|
23
23
|
|
|
24
|
-
1. **
|
|
24
|
+
1. **Sesi baru mulai `DISCUSS`+`AUTO`** untuk membatasi aksi awal; pilih `BUILD` secara eksplisit saat ingin implementasi. `AUTO` mengatur persetujuan dan tidak memberi capability dengan sendirinya.
|
|
25
25
|
2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
|
|
26
26
|
3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
|
|
27
27
|
4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
|
|
@@ -38,4 +38,4 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
38
38
|
- [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
|
|
39
39
|
- [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
|
|
40
40
|
- [Otomasi & CI](exec.md) — batasan headless.
|
|
41
|
-
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|
|
41
|
+
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|
package/docs/cli.md
CHANGED
|
@@ -27,8 +27,9 @@ Semua cara menjalankan Minicode: interaktif, sekali jalan, pipe, dan otomasi CI
|
|
|
27
27
|
| `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only; tidak menghapus) |
|
|
28
28
|
| `minicode doctor [--json]` | Diagnosis lokal |
|
|
29
29
|
| `minicode mcp serve` | Ekspos minicode sebagai MCP server |
|
|
30
|
+
| `minicode openwork [inventory\|context\|export\|merge]` | Baca, susun konteks, ekspor, atau deduplikasi pekerjaan lintas sesi; aksi tidak menjalankan task |
|
|
30
31
|
|
|
31
|
-
Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `skills`, `providers`/`models`/`sync`, `auth`, `pricing`, `exec`, `daemon`, `memory`, `doctor`, `acp`).
|
|
32
|
+
Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `skills`, `providers`/`models`/`sync`, `auth`, `pricing`, `exec`, `daemon`, `memory`, `doctor`, `acp`, `openwork`).
|
|
32
33
|
|
|
33
34
|
## Flags
|
|
34
35
|
|
|
@@ -45,32 +46,41 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
|
|
|
45
46
|
| `--tool-scope <s>` | `full` (default) \| `explore` = subset read-only 12 tool |
|
|
46
47
|
| `--plan` | **Deprecated** — alias untuk `--work-mode PLAN` (read-only planning) |
|
|
47
48
|
| `--allowlist` | Bash hanya perintah aman (tool-access policy warisan) |
|
|
48
|
-
| `--ask` |
|
|
49
|
+
| `--ask` | Minta persetujuan untuk pemanggilan yang digate (human-supervised) |
|
|
49
50
|
| `--allow-all` | Profil akses privileged (path jail + bash-guard tetap aktif) |
|
|
50
51
|
| `--model <name>` | Override model (`providerId::model` paksa provider) |
|
|
51
52
|
| `--provider <id>` | Paksa provider id agnostik |
|
|
52
|
-
| `--resume <id>` | Lanjutkan
|
|
53
|
-
| `--timeout <ms>` | Hard deadline per
|
|
53
|
+
| `--resume <id>` | Lanjutkan history yang tersimpan; setelah kompaksi, bagian lama dapat berupa ringkasan + tail |
|
|
54
|
+
| `--timeout <ms>` | Hard deadline per prompt (default 900000; 0 = Infinity). Sesi yang idle tidak menghabiskan deadline prompt berikutnya. |
|
|
54
55
|
| `--cwd <path>` | Workspace root untuk tool file & jail |
|
|
55
56
|
| `--allow-local-config` | Percayai `.minicode/config.json` + allowlist lokal (default: diabaikan) |
|
|
56
57
|
| `--max-steps <n>` | Batas langkah tool (default 50) |
|
|
57
58
|
| `--context-window <n>` | Ukuran jendela konteks (token) |
|
|
58
59
|
| `--session <id>` | ID sesi (default random, disanitasi) |
|
|
59
|
-
| `--work-mode <m>` | `DISCUSS` \| `PLAN` \| `BUILD` (default). **
|
|
60
|
+
| `--work-mode <m>` | `DISCUSS` \| `PLAN` \| `BUILD` (default: `DISCUSS`). **Work Mode**: `DISCUSS` = investigasi read-only, `PLAN` = perencanaan, `BUILD` = implementasi. Persetujuan hanya `AUTO`/`ASK` (default `AUTO`). Lihat [TUI](repl.md) untuk `/work-mode` |
|
|
60
61
|
| `--enable-scheduler` | Opt-in scheduler otonom (default **off**). Tanpa flag ini, scheduler tidak dibangun sama sekali dan `/scheduler` menjawab "not enabled". Eksekusi manual saja lewat `/scheduler run` — tidak ada timer; turn otonom bersifat read-only. Lihat `/scheduler status` dan `/scheduler stop` |
|
|
61
62
|
| `--runtime <mode>` | `off` (default) \| `constructed` \| `owned`. Arsitektur eksekusi: `off` = perilaku sekarang, tak berubah; `constructed` = runtime + jurnal durable dibangun, turn masih jalan jalur lama; `owned` = setiap turn di-admit lewat runtime (kernel + jurnal durable) dan admission yang ditolak menjalankan tak apa pun. Nilai tak dikenal = `off` |
|
|
62
63
|
|
|
63
|
-
|
|
64
|
+
Tanpa flag, MiniCode memakai `providers[].contextWindows` dari konfigurasi.
|
|
65
|
+
Jika model/gateway tidak punya metadata itu, MiniCode memakai fallback
|
|
66
|
+
32.000 token dan memberi peringatan saat sesi mulai. Gunakan batas model yang
|
|
67
|
+
tepat pada config atau flag; batas yang terlalu kecil memicu kompaksi dini,
|
|
68
|
+
sedangkan batas yang terlalu besar berisiko ditolak provider. Batas berubah
|
|
69
|
+
otomatis saat `/model` mengganti model. MiniCode juga membatasi keluaran stream
|
|
70
|
+
berdasarkan ruang tersisa setelah system prompt, tools, dan riwayat dihitung.
|
|
71
|
+
|
|
72
|
+
Di TUI, **Tab** memutar Work Mode (`Discuss` → `Plan` → `Build`) dan **Shift+Tab** meng-toggle Permission Mode (`Auto` ↔ `Ask`). `/mode <AUTO|ASK>` mengubah persetujuan; `/work-mode <DISCUSS|PLAN|BUILD>` mengubah operating mode. Footer menampilkan Work Mode di kiri dan Permission Mode berwarna cyan di kanan, dekat penggunaan konteks; pada terminal sempit label dipadatkan.
|
|
64
73
|
|
|
65
74
|
## Kapan memakai apa
|
|
66
75
|
|
|
67
76
|
| Tujuan | Pakai |
|
|
68
77
|
|---|---|
|
|
69
|
-
|
|
|
78
|
+
| Memahami repo tanpa perubahan | Default (`DISCUSS` + `AUTO`) — investigasi read-only lokal |
|
|
79
|
+
| Meminta perubahan | `--work-mode BUILD` (`AUTO` default untuk persetujuan) — tool tulis/eksekusi tetap tunduk pada policy |
|
|
70
80
|
| Repo asing / perintah belum dipahami | `--ask` (`BUILD` + `ASK`), jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
|
|
71
81
|
| Review/analisis tanpa eksekusi | `--work-mode PLAN` (atau `--work-mode DISCUSS` untuk investigasi read-only murni) |
|
|
72
82
|
| CI tanpa manusia | `exec --json` + `--budget`/`--max-steps`; `AUTO` menolak `ask_user` deterministik |
|
|
73
|
-
| Otonom penuh di mesin sendiri |
|
|
83
|
+
| Otonom penuh di mesin sendiri | `--work-mode BUILD` + `AUTO`; isolasi tambahan `--sandbox docker` (atau OS) + `--budget` |
|
|
74
84
|
| Model mahal tak terkendali | `--budget 0.50` + `--budget-strict` + `pricing sync` |
|
|
75
85
|
|
|
76
86
|
Detail alasan tiap mode di [Memilih Mode](choosing-mode.md).
|
|
@@ -87,6 +97,7 @@ Kepala tabel penuh ada di [Environment Variables](environment.md); yang paling s
|
|
|
87
97
|
| `MINICODE_SANDBOX_ALLOW_FALLBACK=1` | Izinkan fallback host secara eksplisit bila backend tak tersedia |
|
|
88
98
|
| `MINICODE_BUDGET_STRICT=1` | Sama dengan `--budget-strict` |
|
|
89
99
|
| `MINICODE_ALLOW_LOCAL_CONFIG=1` | Sama dengan `--allow-local-config` |
|
|
100
|
+
| `MINICODE_WORK_MODE` | `DISCUSS` / `PLAN` / `BUILD` — WorkMode default; precedence ada di [Environment Variables](environment.md) |
|
|
90
101
|
| `MINICODE_TOOL_SCOPE=explore` | Subset read-only |
|
|
91
102
|
| `MINICODE_GREP_ENGINE=js` | Paksa walker internal |
|
|
92
103
|
| `MINICODE_MEMORY_SCOPE` | `cwd` \| `global` \| `all` |
|
|
@@ -98,27 +109,9 @@ Kepala tabel penuh ada di [Environment Variables](environment.md); yang paling s
|
|
|
98
109
|
| `MINICODE_ASCII=1` | Glyph ASCII untuk konsol tanpa UTF-8 |
|
|
99
110
|
| `MINICODE_STATUSLINE=rich` | Spinner tampilkan token + biaya sesi |
|
|
100
111
|
|
|
101
|
-
## Config
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
{
|
|
105
|
-
"providers": [{ "id": "my-provider", "baseUrl": "...", "apiKey": "...", "models": ["gpt-4o"] }],
|
|
106
|
-
"mcpServers": [
|
|
107
|
-
{ "id": "fs", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem"] },
|
|
108
|
-
{ "id": "remote", "url": "https://mcp.example.com/mcp", "headers": { "authorization": "Bearer xxx" } }
|
|
109
|
-
],
|
|
110
|
-
"lspServers": [{ "ext": ".ts", "command": "typescript-language-server", "args": ["--stdio"] }],
|
|
111
|
-
"verifyCommand": "bun run typecheck",
|
|
112
|
-
"bashAllowlist": ["git status*", "bun test*", "npm run build*"]
|
|
113
|
-
}
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
Global (`~/.minicode/config.json`) selalu dibaca. Lokal (`.minicode/config.json`)
|
|
117
|
-
adalah input repo tak terpercaya dan DIABAIKAN kecuali operator opt-in per
|
|
118
|
-
invokasi (`--allow-local-config` / `MINICODE_ALLOW_LOCAL_CONFIG=1`) — tanpa
|
|
119
|
-
itu MCP server lokal tidak di-spawn, endpoint provider lokal tidak dipakai,
|
|
120
|
-
`verifyCommand`/`bashAllowlist` lokal tidak berlaku. Tulis eksplisit
|
|
121
|
-
(`config add --local`) tak terpengaruh.
|
|
112
|
+
## Config
|
|
113
|
+
|
|
114
|
+
Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — File & Lokasi Data](config.md). Config lokal tetap diabaikan kecuali operator memilih `--allow-local-config` atau `MINICODE_ALLOW_LOCAL_CONFIG=1`.
|
|
122
115
|
|
|
123
116
|
## Anti-injeksi flag
|
|
124
117
|
|
package/docs/concepts.md
CHANGED
|
@@ -7,7 +7,7 @@ Minicode itu apa, kenapa dibangun begitu, dan kenapa beberapa hal sengaja tidak
|
|
|
7
7
|
| Nama | Apa |
|
|
8
8
|
|---|---|
|
|
9
9
|
| **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP`. Inti di-freeze, zero-dependency, di-vendor ke `vendor/minicore` (isi, jumlah file, dan hash dicatat di `vendor/minicore/VENDOR.md`). Bukan dependency — di-resolve lewat subpath imports `#minicore` |
|
|
10
|
-
| **Minicode** | Layer agencode di atasnya: tools, sub-agents, skills, hooks, policy/sandbox, providers, MCP/LSP, memory, sessions, repo-map, verifier, CLI shell-first |
|
|
10
|
+
| **Minicode** | Layer agencode di atasnya: tools, sub-agents, skills, hooks, policy/sandbox, providers, MCP/LSP, memory, sessions, repo-map, verifier, dan CLI dengan TUI interaktif serta jalur non-interaktif shell-first |
|
|
11
11
|
|
|
12
12
|
|
|
13
13
|
## Loop ReAct
|
package/docs/config.md
CHANGED
|
@@ -6,7 +6,10 @@ Di mana pengaturan dan data Minicode tinggal, dan bagaimana file lokal yang tak
|
|
|
6
6
|
|
|
7
7
|
```json
|
|
8
8
|
{
|
|
9
|
-
"providers": [{
|
|
9
|
+
"providers": [{
|
|
10
|
+
"id": "my-provider", "baseUrl": "...", "apiKey": "...",
|
|
11
|
+
"models": ["gpt-4o"], "contextWindows": { "gpt-4o": 128000, "*": 32000 }
|
|
12
|
+
}],
|
|
10
13
|
"mcpServers": [
|
|
11
14
|
{ "id": "fs", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem"] },
|
|
12
15
|
{ "id": "remote", "url": "https://mcp.example.com/mcp", "headers": { "authorization": "Bearer xxx" } }
|
|
@@ -17,7 +20,8 @@ Di mana pengaturan dan data Minicode tinggal, dan bagaimana file lokal yang tak
|
|
|
17
20
|
}
|
|
18
21
|
```
|
|
19
22
|
|
|
20
|
-
- `providers` — bisa juga diisi lewat wizard/`minicode config add`/`/provider
|
|
23
|
+
- `providers` — bisa juga diisi lewat wizard/`minicode config add`/`/provider`; lihat daftar preset di [Config & Provider](config-providers.md).
|
|
24
|
+
- `providers[].contextWindows` — batas konteks dalam token per model; exact model ID menang, lalu key `"*"` menjadi fallback provider. Nilai harus integer positif. Karena gateway dapat memakai alias model, MiniCode tidak menebak kapasitas provider secara online. `--context-window` mengalahkan nilai config selama sesi itu.
|
|
21
25
|
- `mcpServers` — dua bentuk: stdio (`command`+`args`) dan HTTP (`url`+opsional `headers`). Detail transport di [MCP & LSP](mcp-lsp.md).
|
|
22
26
|
- `verifyCommand` — dipakai `--verify` bila auto-detect tidak menemukan (urutan deteksi: `typecheck` → `test` → `tsconfig`).
|
|
23
27
|
- `bashAllowlist` — pola koma/pola glob perintah bash yang dianggap aman (mode `allowlist`).
|
|
@@ -44,13 +48,14 @@ Kredensial OAuth di `~/.minicode/auth.json` (chmod 600) — terpisah dari config
|
|
|
44
48
|
| `~/.minicode/config.json` | Config global |
|
|
45
49
|
| `~/.minicode/auth.json` | Token OAuth (chmod 600) |
|
|
46
50
|
| `.minicode/config.json` | Config lokal (default diabaikan) |
|
|
47
|
-
| `.minicode/sessions.db` | Sessions SQLite (WAL, capped + busy-retry) |
|
|
48
|
-
| `vector.db` | Index memory vector hybrid |
|
|
51
|
+
| `.minicode/sessions.db` atau `~/.minicode/sessions.db` | Sessions SQLite (WAL, capped + busy-retry); lokasi dipilih oleh `resolveDbPath` berdasarkan keberadaan `.minicode/` workspace |
|
|
52
|
+
| `.minicode/vector.db` atau `~/.minicode/vector.db` | Index memory vector hybrid; memakai aturan lokasi database yang sama dengan sessions |
|
|
53
|
+
| `.minicode/tasks.db` | TaskGraph dan scheduler; selalu lokal pada workspace |
|
|
49
54
|
| `.minicode/repomap.json` | Cache repo-map (sig mtime) |
|
|
50
55
|
| `.minicode/traces.jsonl` | Telemetry per run (prompt di-scrub) |
|
|
51
56
|
| `.minicode/step-traces.jsonl` | Trace keputusan tool (sumber `minicode stats`) |
|
|
52
57
|
| `.minicode/checkpoints/` | Manifest checkpoint (cap 20 terbaru) |
|
|
53
|
-
| `.minicode/todos/<id>.json` + `.minicode/plans/<id>.md` |
|
|
58
|
+
| `.minicode/todos/<id>.json` + `.minicode/plans/<id>.md` | Todo dan artefak rencana per sesi |
|
|
54
59
|
| `.minicode/.trash/` | Soft-delete `delete_file` (cap 100, gitignored) |
|
|
55
60
|
| `.minicode/MEMORY.md` + hierarki | File memory (global → lokal → root) |
|
|
56
61
|
|
package/docs/contributing.md
CHANGED
|
@@ -44,11 +44,11 @@ bun run gate:slow # extreme fuzz + shadow-git stress + MCP adversarial (nightl
|
|
|
44
44
|
|
|
45
45
|
Lambat/stokastik (fuzz multi-seed, stress, docker) tinggal di `slow.yml` — kegagalannya sinyal investigasi, bukan penolakan PR. CI per-commit (`ci.yml`) hanya menjalankan yang deterministik.
|
|
46
46
|
|
|
47
|
-
### Budget ukuran paket (3
|
|
47
|
+
### Budget ukuran paket (3.920 KiB)
|
|
48
48
|
|
|
49
|
-
`bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.
|
|
49
|
+
`bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.920 KiB (3,83 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
Batas 3.920 KiB disetujui pemilik pada 2026-11-05 untuk rilis v0.14.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
|
|
52
52
|
|
|
53
53
|
Gerbang lain:
|
|
54
54
|
|
|
@@ -56,7 +56,7 @@ Gerbang lain:
|
|
|
56
56
|
bun run gate:bash # 62 pola serangan + 24 perintah sah → 0 bypass / 0 over-block
|
|
57
57
|
bun run extreme # fuzz + shadow-git + MCP jahat
|
|
58
58
|
bun run bench:smoke # fake, CI-safe
|
|
59
|
-
bun run vendor:check #
|
|
59
|
+
bun run vendor:check # source MiniCore + overlay host cocok dengan vendor
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
## Batas lapisan (dijaga `test/ui-boundary.test.ts`)
|
|
@@ -66,11 +66,11 @@ bun run vendor:check # vendor/minicore sinkron dengan ../minicore
|
|
|
66
66
|
- `providers → config` satu arah (provisioning di `src/providers/provision.ts`, `src/config.ts` murni IO).
|
|
67
67
|
- Layar `src/ui/screens/` = view murni (props + callback), controller di `cli/`.
|
|
68
68
|
- Jalur non-interaktif shell-first (append-only scrollback); sesi interaktif SELALU TUI alternate-screen (kontrak I16, tanpa opsi linear).
|
|
69
|
-
- Ubah struktur/dependensi antarlapisan → wajib update `docs/
|
|
69
|
+
- Ubah struktur/dependensi antarlapisan → wajib update `docs/architecture.md`.
|
|
70
70
|
|
|
71
71
|
## Aturan kode
|
|
72
72
|
|
|
73
|
-
- Kernel `vendor/minicore/src/core/*` beku.
|
|
73
|
+
- Kernel upstream `vendor/minicore/src/core/*` beku. Overlay host yang disetujui tersimpan di `scripts/vendor-overlays/` dan diterapkan oleh `bun run vendor:minicore`; jangan edit tree vendor atau `VENDOR.md` manual. Butuh seam baru? Buktikan dulu tidak bisa sebagai Tool/Provider/Policy, tambahkan test, lalu pin melalui generator.
|
|
74
74
|
- Limit terpusat di `src/constants.ts` (`LIMITS`) — tanpa magic number tersebar.
|
|
75
75
|
- Semua spawn via `sanitizeSpawnEnv`; semua tulis file via `atomicWriteText`.
|
|
76
76
|
- Satu sumber pola ANSI: `ANSI_PATTERN`/`stripAnsi` di `src/ui/render/theme.ts`.
|
package/docs/environment.md
CHANGED
|
@@ -12,10 +12,12 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
|
|
|
12
12
|
| Variabel | Fungsi |
|
|
13
13
|
|---|---|
|
|
14
14
|
| `MINICODE_TIMEOUT_MS` | Default timeout (ms) bila `--timeout` tidak diset; `0` = Infinity |
|
|
15
|
+
| `NO_UPDATE_CHECK` | `1` → lewati pemeriksaan pembaruan saat startup |
|
|
16
|
+
| `MINICODE_AUTO_UPDATE` | `0`/`false`/`off` → nonaktifkan pemeriksaan dan pemasangan pembaruan otomatis |
|
|
15
17
|
| `MINICODE_PLAN` | `1` → alias warisan `--work-mode PLAN` (tanpa `--plan`) |
|
|
16
18
|
| `MINICODE_PERMISSION` | `allowlist` → tool-access policy bash (profil warisan) |
|
|
17
19
|
| `MINICODE_TOOL_SCOPE` | `explore` → subset read-only 12 tool (sama `--tool-scope explore`) |
|
|
18
|
-
| `MINICODE_WORK_MODE` | `DISCUSS` \| `PLAN` \| `BUILD` → operating mode (sama `--work-mode`; `BUILD`
|
|
20
|
+
| `MINICODE_WORK_MODE` | `DISCUSS` \| `PLAN` \| `BUILD` → operating mode (sama `--work-mode`; default `DISCUSS`; `BUILD` dipetakan ke `EXECUTE` internal; flag menang atas env; nilai tak dikenal gagal ke `DISCUSS` dengan peringatan) |
|
|
19
21
|
| `MINICODE_HOOKS` | `1` → jalankan hook `pre/post-run` dari `~/.minicode/hooks/*.js` & `.minicode/hooks/*.js` (konteks di env `MINICODE_HOOK_CTX`; env hook disanitasi tanpa secret; dilewati bila sesi dibatalkan) |
|
|
20
22
|
| `MINICODE_SESSION_TTL_DAYS` | TTL sesi (default 30; `0` = selamanya) |
|
|
21
23
|
| `MINICODE_HOME` | Override home untuk DB lokal/global (sessions + vector); default `~` |
|
package/docs/exec.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
| `echo "prompt" \| minicode` | Prompt datang dari pipeline/another tool |
|
|
9
9
|
| `minicode exec "prompt" --json` | CI: envelope `minicode.output.v1` JSONL di stdout + baris terakhir `{"type":"summary"}` berversi |
|
|
10
10
|
|
|
11
|
-
`exec --json` memancarkan satu JSON per event lifecycle kanonik (langkah tool, output, error) dengan envelope `minicode.output.v1
|
|
11
|
+
`exec --json` memancarkan satu JSON per event lifecycle kanonik (langkah tool, output, error) dengan envelope `minicode.output.v1`, termasuk `source` dan `visibility`; skema lengkap ada di [Output Protocol Spec](OUTPUT_PROTOCOL_SPEC.md). **Summary** terstruktur berversi muncul di akhir. Kegagalan *setup* (mis. tanpa provider) pun membawa satu baris `{"type":"summary","ok":false,…}` di stdout — stream tak pernah kosong; pesan manusia tetap di stderr, exit `1`. Teks model mengalir sebagai record `{type:"text",delta}` terpisah yang sudah di-scrub dan bebas ANSI.
|
|
12
12
|
|
|
13
13
|
## Ringkasan mesin: field opsional `verify`
|
|
14
14
|
|
|
@@ -56,7 +56,7 @@ kegagalan.
|
|
|
56
56
|
| Method | Params | Balasan |
|
|
57
57
|
|---|---|---|
|
|
58
58
|
| `initialize` | `{client}` | `{server:"minicode-acp", capabilities:{run, streamText, cancel, approval:"deny-headless"}}` |
|
|
59
|
-
| `run` | `{prompt*, cwd?, model?, maxSteps?, timeoutMs?, budget?, mode
|
|
59
|
+
| `run` | `{prompt*, cwd?, model?, maxSteps?, timeoutMs?, budget?, mode?, workMode?:"DISCUSS"\|"PLAN"\|"BUILD"}` | notifikasi lifecycle (`turn.*`, `tool.*`, `approval.*`, `file.changed`, `test.completed`, `diagnostic.raised`, `checkpoint.created`, `plan.updated`, `finding.detected`, `result.produced`, `context.compacted`) + `{type:"text",delta}`, lalu `{ok,tokens,steps,turns,text}` atau `{error}` (`{type:"tool",name}` hanya legacy bila lifecycle absen). `workMode` terpisah dari `mode`; lihat [CLI](cli.md). |
|
|
60
60
|
| `cancel` | — | `{cancelled:true/false}` (menggugurkan run berjalan) |
|
|
61
61
|
| `shutdown` | — | keluar 0 |
|
|
62
62
|
|
|
@@ -70,7 +70,7 @@ printf '%s\n' '{"id":1,"method":"initialize"}' '{"id":2,"method":"shutdown"}' |
|
|
|
70
70
|
|
|
71
71
|
Tool `submit_result` menghasilkan JSON akhir terstruktur, dipanggil paling banyak 1× per run, dengan mode `NO_PROMPT` (tidak minta konfirmasi). Di `exec --json`, isi hasil diteruskan **verbatim** — pengganti `response_format` ala API. Bila `result.findings` berisi daftar eksplisit `{category, severity, summary, evidence?}`, temuan tersebut juga diproyeksikan sebagai event `finding.detected`. Cocok untuk tugas yang hasilnya dikonsumsi program lain, bukan manusia.
|
|
72
72
|
|
|
73
|
-
Mode `--json`
|
|
73
|
+
Mode `--json` memakai envelope lifecycle dan summary yang dijelaskan di atas serta di [Output Protocol Spec](OUTPUT_PROTOCOL_SPEC.md); teks model tetap record `{type:"text",delta}` terpisah. Setup failure selalu membawa satu baris summary `ok:false`.
|
|
74
74
|
|
|
75
75
|
## Klarifikasi mid-run: `ask_user`
|
|
76
76
|
|
|
@@ -91,8 +91,8 @@ Mode `--json` menulis envelope `minicode.output.v1` untuk lifecycle kanonik (`ev
|
|
|
91
91
|
|
|
92
92
|
```bash
|
|
93
93
|
# gate PR: verify + budget ketat + hasil JSON
|
|
94
|
-
minicode exec
|
|
95
|
-
|
|
94
|
+
minicode exec --work-mode BUILD --verify --json --budget 0.50 --budget-strict --max-steps 40 \
|
|
95
|
+
"perbaiki lint di src/ lalu jalankan bun run lint"
|
|
96
96
|
|
|
97
97
|
# pakai provider tertentu tanpa mengubah config
|
|
98
98
|
minicode exec "ringkas diff ini" --json --provider openai --model gpt-4o
|
package/docs/getting-started.md
CHANGED
|
@@ -63,22 +63,24 @@ Docker **tidak** dipakai otomatis meski tersedia — menarik image tanpa diminta
|
|
|
63
63
|
## Update & uninstall
|
|
64
64
|
|
|
65
65
|
Membuka `minicode` interaktif (TTY) selalu cek versi terbaru ke registry:
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
66
|
+
versi SemVer tepat yang ditemukan diverifikasi dahulu lewat instalasi sementara
|
|
67
|
+
dan `npm audit signatures` (signature registry + provenance). Skrip instalasi
|
|
68
|
+
paket dimatikan; hanya graph tanpa dependency runtime yang diterima. Setelah
|
|
69
|
+
itu versi yang sama dipasang dari registry resmi, versi di package terpasang
|
|
70
|
+
dibaca ulang, lalu minicode restart sendiri. Ketidakcocokan mencoba memulihkan
|
|
71
|
+
versi sebelumnya; bila pemulihan gagal, proses berhenti agar tidak berjalan
|
|
72
|
+
dengan instalasi campuran. Berlaku hanya untuk salinan ter-install (checkout
|
|
73
|
+
source tidak disentuh). Npm lama, paket tanpa bukti signature/provenance,
|
|
74
|
+
offline, atau install gagal menahan auto-update dan memberi instruksi manual.
|
|
70
75
|
One-shot, `exec`, pipe, dan CI hanya menampilkan notifikasi (tanpa install).
|
|
71
76
|
|
|
72
|
-
>
|
|
73
|
-
>
|
|
74
|
-
>
|
|
75
|
-
>
|
|
76
|
-
> TLS registry + rilis hanya dari CI repo ini; yang butuh jaminan lebih,
|
|
77
|
-
> matikan auto-update (`MINICODE_AUTO_UPDATE=0`) dan update manual setelah
|
|
78
|
-
> memeriksa rilis di GitHub.
|
|
77
|
+
> Verifikasi memakai kemampuan npm, bukan verifier Sigstore yang dibundel
|
|
78
|
+
> MiniCode. Gagal-verifikasi selalu menghentikan update otomatis. Pemilik tetap
|
|
79
|
+
> dapat mematikan jalur ini (`MINICODE_AUTO_UPDATE=0`) dan mengelola update
|
|
80
|
+
> manual sesuai kebijakan organisasinya.
|
|
79
81
|
|
|
80
82
|
```bash
|
|
81
|
-
npm
|
|
83
|
+
npm install -g minicode-ai@<versi> # manual, gunakan versi yang sudah ditinjau
|
|
82
84
|
minicode sync # refresh model baru dari semua provider
|
|
83
85
|
minicode pricing sync # refresh cache harga (3.162 model, ~213 KB)
|
|
84
86
|
```
|
package/docs/glossary.md
CHANGED
|
@@ -6,17 +6,19 @@ Istilah Minicode yang punya makna spesifik. Dokumentasi berbahasa Indonesia deng
|
|
|
6
6
|
|---|---|
|
|
7
7
|
| **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP` di-vendor ke `vendor/minicore`; inti beku, zero-dep, di-resolve via `#minicore` |
|
|
8
8
|
| **Minicode** | Layer agencode di atas MiniCore: tools, agents, policy, providers, memory, sessions, CLI |
|
|
9
|
-
| **Tool** | Kemampuan yang dipilih model dalam loop ReAct
|
|
10
|
-
| **Tool scope** | `full`
|
|
11
|
-
| **
|
|
9
|
+
| **Tool** | Kemampuan yang dipilih model dalam loop ReAct; tool MCP dapat ditambahkan dinamis sebagai `serverId.toolName` |
|
|
10
|
+
| **Tool scope** | `full` atau subset read-only `explore` — flag `--tool-scope` |
|
|
11
|
+
| **WorkMode** | Cara agent bekerja: `DISCUSS`, `PLAN`, atau `BUILD` (alias produk untuk identitas internal `EXECUTE`) |
|
|
12
|
+
| **PermissionMode** | Pilihan pengawasan: `AUTO` menjalankan capability yang diotorisasi; `ASK` meminta persetujuan untuk aksi yang digate |
|
|
13
|
+
| **Tool Access Policy** | Batas capability yang tersedia, seperti read-only, allowlist, atau profil akses warisan `--allow-all` |
|
|
12
14
|
| **Gate** | Tool wajib persetujuan manusia saat TTY; non-TTY selalu tolak (mis. `git_commit`, MCP, `delegate_task`) |
|
|
13
|
-
| **Path jail** | Pembatasan akses file ke workspace (realpath + symlink
|
|
15
|
+
| **Path jail** | Pembatasan akses file ke workspace (realpath + symlink; `O_NOFOLLOW` pada POSIX dan pencocokan identitas handle `dev+ino` pada semua platform); aktif bahkan `--allow-all` |
|
|
14
16
|
| **Bash-guard** | Normalisasi + blokir pola bash berbahaya sebelum eksekusi (quote-split, indirection, wrapper) |
|
|
15
17
|
| **Sandbox OS** | bubblewrap (Linux) / seatbelt (macOS) — otomatis bila tersedia |
|
|
16
18
|
| **Sandbox Docker** | Container ephemeral `--network none`, 512m, 1 CPU, `node:22-alpine` |
|
|
17
19
|
| **Checkpoint** | Snapshot per turn via shadow-git: SHA tree di `refs/minicode/…` (O(delta), HEAD/index tak tersentuh) |
|
|
18
|
-
| **Recovery journal** | `journal-<sesi>.jsonl`: `pending` → `committed
|
|
19
|
-
| **Session** | Riwayat
|
|
20
|
+
| **Recovery journal** | `journal-<sesi>.jsonl`: `pending` → `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn yang sudah durable |
|
|
21
|
+
| **Session** | Riwayat tersimpan di `.minicode/sessions.db` (SQLite WAL); kompaksi dapat mengganti bagian lama dengan ringkasan + tail |
|
|
20
22
|
| **Memory dua lapis** | `MEMORY.md` hierarki (selalu ke system prompt) + vector RAG hybrid (injeksi bila skor ≥ ambang) |
|
|
21
23
|
| **RAG hybrid** | Pencarian memory cosine 0.7 + keyword 0.3, ranking MMR (λ 0.7), dedup >0.92 |
|
|
22
24
|
| **Repo-map** | Simbol per file (regex 9 bahasa, fallback LSP) disuntik ke system prompt |
|
|
@@ -29,7 +31,7 @@ Istilah Minicode yang punya makna spesifik. Dokumentasi berbahasa Indonesia deng
|
|
|
29
31
|
| **Transient** | UI muncul-sekali yang menghapus dirinya (spinner, garis status turn) — vs transkrip yang menetap |
|
|
30
32
|
| **Composition root** | `cli/index.ts` + `cli/setup.ts`: satu tempat wiring DI (provider, RAG, session, tools) |
|
|
31
33
|
| **Seam aditif** | Satu-satunya patch yang dibolehkan ke kernel beku: `compactAsync`, `initialMessages`, `cwd` |
|
|
32
|
-
| **Self-contained** | Tanpa clone repo lain — kernel di-vendor, runtime zero-dep, butuh Bun ≥ 1.
|
|
34
|
+
| **Self-contained** | Tanpa clone repo lain — kernel di-vendor, runtime zero-dep, butuh Bun ≥ 1.1.13 |
|
|
33
35
|
|
|
34
36
|
## Lanjut
|
|
35
37
|
|
package/docs/mcp-lsp.md
CHANGED
|
@@ -30,7 +30,7 @@ Keamanan HTTP: host privat ditolak kecuali `--allow-private` (penjaga sama denga
|
|
|
30
30
|
|
|
31
31
|
Izin: semua MCP bertitik selalu di-gate — `auto` minta konfirmasi sekali per tool (`[a] Always` persist ke allowlist); `readonly`/`plan`/`allowlist` menolak. Tanpa wildcard auto-allow (proteksi supply-chain).
|
|
32
32
|
|
|
33
|
-
Model kepercayaan: permission hanya kontrol *pemanggilan*. Capability di balik server (filesystem, network, proses, API) tak bisa diketahui statis — anggap setiap `mcp_call` external capability arbitrer. Pembatalan
|
|
33
|
+
Model kepercayaan: permission hanya kontrol *pemanggilan*. Capability di balik server (filesystem, network, proses, API) tak bisa diketahui statis — anggap setiap `mcp_call` external capability arbitrer. Pembatalan menghentikan penungguan lokal, tetapi tidak membuktikan bahwa server berhenti atau membatalkan efek yang sudah diterima. Jika koneksi terputus setelah request dikirim, tool mengembalikan error `outcome unknown`; periksa state remote sebelum mencoba lagi.
|
|
34
34
|
|
|
35
35
|
Ekspos balik (stdio saja — tanpa mode HTTP, jadi tak ada permukaan jaringan):
|
|
36
36
|
|
package/docs/memory-sessions.md
CHANGED
|
@@ -26,7 +26,7 @@ Embedding: default `text-embedding-3-small` (`MINICODE_EMBED_MODEL`). Dim-mismat
|
|
|
26
26
|
|
|
27
27
|
## Sessions
|
|
28
28
|
|
|
29
|
-
Sesi di `.minicode/sessions.db` (WAL, capped + busy-retry async). `--resume <id>` melanjutkan
|
|
29
|
+
Sesi di `.minicode/sessions.db` (WAL, capped + busy-retry async). `--resume <id>` melanjutkan history yang saat itu tersimpan, termasuk `toolCallId`/`name`; setelah kompaksi, history lama dapat sudah diganti ringkasan + tail sehingga bukan salinan penuh percakapan awal. Workspace dibandingkan ke checkpoint terakhir dan divergensi dilaporkan (bukan replay buta). TTL 30 hari (`MINICODE_SESSION_TTL_DAYS=0` = selamanya). `minicode sessions purge` hapus manual. Branch via `branchSession` (fork dari history tersimpan + turns).
|
|
30
30
|
|
|
31
31
|
Satu penulis per sesi (P2.2): komposisi mengakuisisi lease otoritas (`tasks.db: session_authority`) saat start dan melepasnya saat close; proses kedua pada sesi yang sama ditolak (`REFUSED_LEASE_HELD`). Setiap mutasi sesi membawa `writer_epoch` yang di-CAS di dalam transaksi SQLite yang sama — penulis basi setelah takeover ditolak (`REFUSED_STALE_EPOCH`), tanpa tulis parsial. Tiga konsep tetap berbeda: **lease** = admission (boleh menulis), **writer_epoch** = pagar mutasi (tulisan ini masih sah), **incarnation** = generasi identitas lintas delete/recreate.
|
|
32
32
|
|
|
@@ -44,10 +44,10 @@ Batas: snapshot memakai `git add -A`, jadi file ber-`.gitignore` tidak ikut (dis
|
|
|
44
44
|
|
|
45
45
|
## Recovery journal
|
|
46
46
|
|
|
47
|
-
Setiap mutasi (tulis/edit/hapus, `bash`, `git_commit`, `mcp_call`, `code_run`, `delegate_task`, memory tulis/hapus) dicatat di `.minicode/journal-<sesi>.jsonl` — di kode disebut *mutation journal*: `pending` → `committed`/`failed
|
|
47
|
+
Setiap mutasi (tulis/edit/hapus, `bash`, `git_commit`, `mcp_call`, `code_run`, `delegate_task`, memory tulis/hapus) dicatat di `.minicode/journal-<sesi>.jsonl` — di kode disebut *mutation journal*: `pending` → `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn yang sudah durable di SQLite. Saat resume, dibaca **sebelum** seed kernel:
|
|
48
48
|
|
|
49
49
|
- `committed` yang turn-nya hilang → tidak diulang; model diberi catatan narasi.
|
|
50
|
-
- `pending`/`failed` → direktif verifikasi; dilarang redo buta.
|
|
50
|
+
- `pending`/`failed`/`unknown` → direktif verifikasi; dilarang redo buta.
|
|
51
51
|
- `committed` MCP = *external-acknowledged*, wajib baca-balik.
|
|
52
52
|
|
|
53
53
|
Jurnal bukan transaksi atomik; `pending` = ambigu (efek mungkin sudah terjadi). Hanya hash + path relatif (tanpa isi/kredensial). File dibuat eager saat sesi terpasang. Jurnal anak terpisah per sesi anak. `sessions purge` ikut hapus jurnal basi.
|
|
@@ -56,8 +56,10 @@ Jurnal bukan transaksi atomik; `pending` = ambigu (efek mungkin sudah terjadi).
|
|
|
56
56
|
|
|
57
57
|
Model hanya melihat jendela riwayat terbatas (**konteks**). Saat percakapan menekan jendela itu, Minicode **memadatkan** (compaction): turn lama diganti satu ringkasan, turn terbaru dipertahankan utuh. Anda melihatnya sebagai baris `── compacted: …` di output.
|
|
58
58
|
|
|
59
|
-
|
|
60
|
-
|
|
59
|
+
Batas konteks dibaca per model dari `providers[].contextWindows` (exact model ID, lalu `"*"`); `--context-window` mengalahkan config untuk sesi itu. Bila metadata tidak ada, fallback 32.000 token diberi peringatan. Saat model berganti, admission dan pemutus stream mengikuti batas model baru. Estimator juga dikalibrasi per provider/model setelah usage aktual; CJK dan emoji tidak lagi dihitung sebagai teks biasa `chars/4`.
|
|
60
|
+
|
|
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
|
+
- **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.
|
|
61
63
|
- **Yang mungkin hilang:** teks lengkap turn lama (dipotong ~250 char/baris saat diringkas), detail output tool, urutan persis percakapan.
|
|
62
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`.
|
|
63
65
|
- **Ringkasan lebih cerdas bila ada kunci DeepSeek** (`DEEPSEEK_API_KEY`): ringkasan dibuat LLM (timeout 10 dtk); tanpanya dipakai ringkasan mekanikal. Keduanya memagar konten tak-terpercaya sebagai data + secret-scrub sebelum diringkas.
|
package/docs/policy-sandbox.md
CHANGED
|
@@ -1,21 +1,16 @@
|
|
|
1
1
|
# Policy & Sandbox
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
WorkMode, persetujuan, tool access policy, penjaga perintah shell, dan isolasi eksekusi adalah kontrol yang berbeda. Hard deny path jail, state milik runtime, dan bash guard tetap berlaku di atasnya.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Tiga sumbu kontrol
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
| Sumbu | Nilai | Fungsi |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| **WorkMode** | `DISCUSS` / `PLAN` / `BUILD` (`EXECUTE` internal) | Membatasi cara agent bekerja. `DISCUSS` read-only; `PLAN` boleh membuat artefak rencana; `BUILD` tidak menambah ceiling. WorkMode hanya mempersempit akses. |
|
|
10
|
+
| **PermissionMode** | `AUTO` / `ASK` | Menentukan pengawasan manusia. `AUTO` menjalankan capability yang diotorisasi tanpa persetujuan rutin; `ASK` meminta persetujuan untuk aksi yang digate. Hard deny tetap berlaku. |
|
|
11
|
+
| **Tool Access Policy** | capability read-only, plan, allowlist, profil akses warisan | Menentukan capability yang tersedia. Nilai internal `readonly`, `plan`, `allowlist`, dan `allow-all` masih dipakai untuk kompatibilitas dan batas akses, bukan sebagai pilihan pengawasan. |
|
|
8
12
|
|
|
9
|
-
|
|
10
|
-
|---|---|
|
|
11
|
-
| `auto` | Readonly + gated-prompt + file/internal-write allow; `code_run`/`bash` dengan guard. `delegate_task`/`mcp_call`/semua MCP bertitik di-gate (prompt saat TTY, tolak tanpa TTY) |
|
|
12
|
-
| `ask` | Readonly + `NO_PROMPT_TOOLS` auto-allow; sisanya prompt/TTY + allowlist persist |
|
|
13
|
-
| `readonly` | Gerbang izin: 18 tool `READONLY_TOOLS`. Visibilitas: model hanya melihat 12 tool baca (`EXPLORE_TOOL_NAMES`) |
|
|
14
|
-
| `plan` | `readonly` + `todo_write` + `delegate_task` (anak dipaksa explore/read-only) + `submit_result`. Tetap tanpa mutasi file/git/memory |
|
|
15
|
-
| `allowlist` | Bash hanya pola `DEFAULT_BASH_ALLOWLIST`/env; file-write/internal-write sesuai set. Diwariskan ke sub-agent (parent allowlist → anak allowlist, bukan auto) |
|
|
16
|
-
| `allow-all` | Allow semua; **tetap** tolak bash berbahaya + path jail tetap aktif |
|
|
17
|
-
|
|
18
|
-
Cycle Tab/Shift+Tab hanya 5 (`auto,ask,plan,allowlist,allow-all` — `allow-all` dilewati agar tak aktif tak sengaja). Mode bisa dioverride: `--plan`, `--allowlist`, `--ask`, `--allow-all`, `MINICODE_PLAN=1`, `MINICODE_PERMISSION=allowlist`, `Shift+Tab` runtime.
|
|
13
|
+
`PermissionMode` internal masih berupa union kompatibilitas yang juga memuat profil akses warisan. Untuk pilihan mode, flag, dan kombinasi yang menghadap pengguna, lihat [Memilih Mode](choosing-mode.md) dan [CLI](cli.md). Delegasi juga mewarisi batas parent; lihat [Sub-Agents & Tasks](agents.md).
|
|
19
14
|
|
|
20
15
|
Set terkait: `INTERNAL_WRITE_TOOLS`, `FILE_WRITE_TOOLS`, `GATED_TOOLS` (+ `*.*` MCP), `NO_PROMPT_TOOLS`. `move_file`/`delete_file` dijail di permission layer (berlaku semua mode termasuk `--allow-all`).
|
|
21
16
|
|
|
@@ -31,11 +26,18 @@ Set terkait: `INTERNAL_WRITE_TOOLS`, `FILE_WRITE_TOOLS`, `GATED_TOOLS` (+ `*.*`
|
|
|
31
26
|
| `node --eval "1"` | ditolak |
|
|
32
27
|
| `env`, `set`, `export -p` | ditolak |
|
|
33
28
|
| `curl -F file=@~/.ssh/id_rsa` | ditolak |
|
|
29
|
+
| `echo x > ..\evil` (redirect keluar workspace) | ditolak; target redirect di-resolve ke cwd sebelum lolos allowlist |
|
|
30
|
+
| `echo x > "%TEMP%\evil"` | ditolak; target berisi ekspansi `%NAMA%` tak bisa dipastikan aman secara statis |
|
|
31
|
+
| `py -c …`, `python3.14 -c …` | ditolak bersama varian launcher dan versi Python |
|
|
34
32
|
| `type ..\..\windows\system32\config\sam`, `Get-Content .../ntds.dit` | ditolak (hive Windows + `reg save|export` hive + `vssadmin create|delete shadow` + `ntdsutil`; `reg query`, `vssadmin list`, `system.txt` biasa tetap lolos) |
|
|
35
33
|
| `write_file .minicode/<apa-pun>` | ditolak fail-closed (kunci penuh segmen `.minicode/`; kecuali restore `.trash/` → workspace dan skrip `.minicode/hooks/`) |
|
|
36
34
|
| `bash <(curl x)` | ditolak |
|
|
37
35
|
| `rm -rf ..`, `rm --recursive --force /`, `rm -rf /; :` | ditolak |
|
|
38
36
|
| `command env`, `nice env`, dkk. (wrapper) | deteksi env-dump ter-anchor ke awal | ditolak via `stripCommandWrappers` (buang wrapper berlapis) |
|
|
37
|
+
| Baca lewat hardlink menuju luar workspace | ditolak jika handle yang dibuka memiliki `nlink > 1`; pengecekan memakai `fstat` |
|
|
38
|
+
| `type .e^nv`, `ty^pe .env` (escape caret cmd.exe) | ditolak setelah caret dinormalisasi sebelum aturan nama/jail |
|
|
39
|
+
| `type %USERPROFILE%\notes.txt` | ditolak; argumen pembaca berpola `%NAMA%` tak bisa dipastikan aman |
|
|
40
|
+
| `for /f %i in (.env) do @echo %i` | ditolak; file set pada loop `for /f` ikut diperiksa |
|
|
39
41
|
|
|
40
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.
|
|
41
43
|
|
|
@@ -61,12 +63,18 @@ Fuzz membangkitkan varian dari transformasi yang shell anggap setara (quote-spli
|
|
|
61
63
|
| `--sandbox docker` | Container ephemeral (`--network none`, 512m, 1 CPU, `node:22-alpine`) |
|
|
62
64
|
| `--sandbox docker` tapi daemon mati | TOLAK sebelum jalan (fail-closed) + cara opt-in fallback eksplisit; tidak pura-pura terisolasi |
|
|
63
65
|
|
|
66
|
+
Container mendapat nama acak per-run. Saat batas waktu habis atau tool dibatalkan,
|
|
67
|
+
runner meminta daemon menjalankan `docker rm --force` dengan timeout cleanup
|
|
68
|
+
5 detik sebelum menghentikan penunggu CLI. Output membedakan cleanup yang
|
|
69
|
+
dikonfirmasi daemon dari yang tidak terkonfirmasi. Ini tidak membatalkan efek
|
|
70
|
+
workspace yang sudah terjadi sebelum container dihentikan.
|
|
71
|
+
|
|
64
72
|
`MINICODE_SANDBOX_STRICT=1` = tak pernah fallback host (redundan dengan default fail-closed untuk request eksplisit, tetap dihormati). `MINICODE_SANDBOX_ALLOW_FALLBACK=1` = satu-satunya jalan fallback host yang sadar bila backend tak tersedia. `MINICODE_SANDBOX_IMAGE` ganti image (default `node:22-alpine` hanya bawa node). `code_run` selalu lewat sandbox runner dan menolak bila backend tak tersedia.
|
|
65
73
|
|
|
66
74
|
## Lapisan lain
|
|
67
75
|
|
|
68
|
-
- **Path jail** realpath-based + symlink `realpath` di permission layer; `.env`/`.git/config`/`node_modules`/hive Windows deny; `.minicode/` terkunci penuh untuk tool tulis berdasarkan target NYATA (realpath best-effort `isOwnedStateReal` — junction/symlink internal ke `.minicode/` ikut ditahan; kecuali restore `.trash/` + skrip `hooks/`); bash-guard menahan PEMBUATAN link yang operannya sensitif/owned-state
|
|
69
|
-
- **Env scrub** `sanitizeSpawnEnv`: strip kata-kunci kredensial dari merge final; `GITHUB_WORKSPACE`/`REDIS_HOST`/`AWS_REGION` tetap ada, `GITHUB_TOKEN`/`AWS_SECRET_ACCESS_KEY`/`DATABASE_URL` tetap di-strip.
|
|
76
|
+
- **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
|
+
- **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.
|
|
70
78
|
- **web_fetch/web_search**: redirect manual 5 hop + DNS pinning 30 dtk + body 2 MB.
|
|
71
79
|
- **Secret scrubber**: `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` di-redact sebelum ke LLM (read_file/bash/grep) — tanpa whitelist kata.
|
|
72
80
|
- **Config/allowlist**: atomic randomUUID tmp+rename + chmod 600. MCP serve curated tools + permission aktif.
|