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.
Files changed (130) hide show
  1. package/README.md +34 -178
  2. package/cli/args.ts +10 -18
  3. package/cli/auto-update.ts +32 -2
  4. package/cli/commands/acp.ts +20 -27
  5. package/cli/commands/daemon.ts +6 -7
  6. package/cli/commands/exec.ts +12 -10
  7. package/cli/commands.ts +6 -9
  8. package/cli/index.ts +40 -17
  9. package/cli/provider-manager.ts +1 -3
  10. package/cli/setup.ts +174 -145
  11. package/cli/tui.ts +33 -38
  12. package/docs/CONTROL-PLANE-MAP.md +145 -0
  13. package/docs/OUTPUT_EVENT_MODEL.md +1 -1
  14. package/docs/OUTPUT_PROTOCOL_SPEC.md +8 -2
  15. package/docs/OUTPUT_RENDERING_SPEC.md +35 -6
  16. package/docs/OUTPUT_UX_RULES.md +1 -1
  17. package/docs/README.md +14 -102
  18. package/docs/SUMMARY.md +53 -0
  19. package/docs/TERMINAL_CONTRACT.md +136 -77
  20. package/docs/UI_RENDER_PIPELINE.md +204 -0
  21. package/docs/agents.md +5 -5
  22. package/docs/architecture.md +23 -12
  23. package/docs/choosing-mode.md +7 -7
  24. package/docs/cli.md +22 -29
  25. package/docs/concepts.md +1 -1
  26. package/docs/config.md +10 -5
  27. package/docs/contributing.md +6 -6
  28. package/docs/environment.md +3 -1
  29. package/docs/exec.md +5 -5
  30. package/docs/getting-started.md +14 -12
  31. package/docs/glossary.md +9 -7
  32. package/docs/mcp-lsp.md +1 -1
  33. package/docs/memory-sessions.md +7 -5
  34. package/docs/policy-sandbox.md +23 -15
  35. package/docs/quickstart.md +2 -2
  36. package/docs/repl.md +4 -3
  37. package/docs/security-model.md +16 -17
  38. package/docs/security.md +15 -30
  39. package/docs/skills.md +1 -1
  40. package/docs/tools.md +6 -6
  41. package/docs/verify-benchmark.md +16 -0
  42. package/package.json +5 -5
  43. package/scripts/vendor-overlays/minicode-context.patch +109 -0
  44. package/src/app/mentions.ts +4 -3
  45. package/src/app/provider-layer.ts +13 -1
  46. package/src/app/session.ts +229 -22
  47. package/src/app/tool-layer.ts +6 -0
  48. package/src/config.ts +30 -3
  49. package/src/constants.ts +19 -0
  50. package/src/daemon/control.ts +1 -1
  51. package/src/lib/git-hardening.ts +27 -22
  52. package/src/lib/safe-open.ts +73 -19
  53. package/src/lib/trusted-exec.ts +7 -4
  54. package/src/mcp/client.ts +34 -9
  55. package/src/mcp/server.ts +2 -3
  56. package/src/mcp/transport.ts +96 -42
  57. package/src/memory/files.ts +15 -4
  58. package/src/memory/vector.ts +5 -1
  59. package/src/policy/compaction.ts +272 -16
  60. package/src/policy/context-window.ts +73 -0
  61. package/src/policy/context.ts +76 -16
  62. package/src/policy/ratelimit.ts +47 -18
  63. package/src/policy/tool-contract.ts +4 -10
  64. package/src/policy/update-check.ts +83 -6
  65. package/src/policy/usage.ts +31 -14
  66. package/src/policy/work-mode.ts +1 -1
  67. package/src/presentation/adapter.ts +64 -2
  68. package/src/presentation/events.ts +6 -0
  69. package/src/presentation/model.ts +1 -0
  70. package/src/presentation/projection.ts +2 -0
  71. package/src/presentation/reducer.ts +1 -0
  72. package/src/providers/anthropic.ts +52 -19
  73. package/src/providers/guards.ts +158 -16
  74. package/src/providers/provision.ts +12 -3
  75. package/src/providers/responses.ts +61 -23
  76. package/src/providers/router.ts +56 -23
  77. package/src/providers/sse-bounds.ts +170 -0
  78. package/src/repo/repomap.ts +10 -11
  79. package/src/runtime/execution-backend.ts +7 -8
  80. package/src/sandbox/docker.ts +113 -9
  81. package/src/session/checkpoint.ts +9 -2
  82. package/src/session/context-projection.ts +14 -0
  83. package/src/session/context-selector.ts +58 -20
  84. package/src/session/persistence.ts +6 -3
  85. package/src/session/verification.ts +55 -16
  86. package/src/skills/loader.ts +16 -3
  87. package/src/task/model.ts +21 -70
  88. package/src/tools/bash.ts +6 -3
  89. package/src/tools/code_run.ts +6 -5
  90. package/src/tools/context.ts +8 -0
  91. package/src/tools/delete_file.ts +2 -1
  92. package/src/tools/edit.ts +2 -1
  93. package/src/tools/git.ts +128 -54
  94. package/src/tools/glob.ts +2 -1
  95. package/src/tools/grep.ts +31 -6
  96. package/src/tools/lsp.ts +5 -4
  97. package/src/tools/mcp_call.ts +3 -1
  98. package/src/tools/memory.ts +175 -180
  99. package/src/tools/move_file.ts +2 -1
  100. package/src/tools/patch.ts +2 -1
  101. package/src/tools/read_file.ts +94 -1
  102. package/src/tools/read_image.ts +2 -1
  103. package/src/tools/task.ts +9 -1
  104. package/src/tools/todo.ts +4 -5
  105. package/src/tools/web_fetch.ts +28 -12
  106. package/src/tools/web_search.ts +28 -9
  107. package/src/tools/write_file.ts +2 -1
  108. package/src/ui/assistant/simple.ts +72 -3
  109. package/src/ui/footer.ts +131 -66
  110. package/src/ui/i18n/en.ts +3 -11
  111. package/src/ui/i18n/id.ts +3 -11
  112. package/src/ui/input/input.ts +2 -3
  113. package/src/ui/input/prompt-engine.ts +2 -5
  114. package/src/ui/render/width.ts +107 -79
  115. package/src/ui/runtime/screen.ts +49 -37
  116. package/src/ui/screens/model-manager.ts +3 -10
  117. package/src/ui/screens/picker.ts +23 -40
  118. package/src/ui/screens/provider-manager.ts +12 -33
  119. package/src/ui/screens/wizard.ts +0 -1
  120. package/src/ui/tui/app.ts +265 -211
  121. package/src/ui/tui/transcript.ts +87 -8
  122. package/vendor/minicore/VENDOR.md +9 -5
  123. package/vendor/minicore/src/core/loop.ts +47 -12
  124. package/vendor/minicore/src/core/provider.ts +4 -0
  125. package/vendor/minicore/src/core/session.ts +14 -1
  126. package/CHANGELOG.md +0 -1185
  127. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
  128. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
  129. package/docs/PLAN_UIUX_V6.md +0 -209
  130. package/docs/changelog.md +0 -3
@@ -1,8 +1,8 @@
1
1
  # Arsitektur
2
2
 
3
- Peta struktur hidup yang interaktif ada di `ARCHITECTURE.html` (file pendamping di folder ini — search/filter, 9 section `00 Sekilas` → `09 UI/UX rendering terminal`). Halaman ini ringkasannya agar bisa dibaca GitBook + AI Ask.
3
+ Dokumen ini adalah peta struktur dan alur runtime yang aktif untuk kontributor.
4
4
 
5
- Rencana aktif: **roadmap arsitektur = `ROADMAP.md` di root repo** (master roadmap milik pemilik, disalin 2026-10-21) — di situulah posisi Big Phase P1–P14, next action arsitektur, dan status track Quality Remediation. `PLAN.md` di root tetap ada sebagai **ledger produk/milestone legacy** (`LEGACY-0.9/*`), bukan sumber status fase (lihat tabel disambiguasi di `AGENTS.md`). Kontrak terminal FROZEN: `TERMINAL_CONTRACT.md` (folder ini) — baca sebelum menyentuh output/rendering; perubahan perilaku wajib update dokumen + test peta proteksinya. Audit dan target output architecture: [OUTPUT_ARCHITECTURE_AUDIT.md](OUTPUT_ARCHITECTURE_AUDIT.md) beserta [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), [UX](OUTPUT_UX_RULES.md), dan [implementation plan](OUTPUT_IMPLEMENTATION_PLAN.md). Riset harness: `HARNESS.md` (folder ini). Arsip: `PLAN_UIUX_V6.md` (selesai, jangan dikerjakan ulang).
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` | continuity/resume |
33
- | Vektor memory + `presentation_events` | ringkasan compaction, evento semantik | RAG & audit UI |
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
- `context_eviction ≠ state_loss`: memangkas yang working boleh, hilang dari
36
- durable tidak. Karena itu pagu summary kompaksi
37
- (`LIMITS.COMPACTION_SUMMARY_MAX_CHARS`) aman dipakai — fakta penuh tetap ada di
38
- `messages` dan vektor memory.
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** (lihat `docs/TASK_ARCHITECTURE_AUDIT.md` untuk
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 mode model cwd` (timer redup idle; saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; konteks rata kanan; 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).
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` (25 semantic event types + proposed marker), `adapter.ts` (runtime → DomainEvent), `reducer.ts`/`model.ts` (replayable bounded state + derived summary), `store.ts` (content refs), `projection.ts` (policy node/mode + envelope `minicode.output.v1` + kategori error machine, murni), dan `src/session/persistence.ts` (`presentation_events` durable log + `messages` dengan fidelity `reasoning`/`is_error`). `cli/setup.ts` memiliki exhaustive `toPresentationEvent()` bridge; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy` (rollback flag dihapus di Phase 8).
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).
@@ -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 tool baca); network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
16
- | Minta agen membuat perubahan | `BUILD` + `AUTO` (default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
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 | `BUILD`+`AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
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. **Default `BUILD`+`AUTO` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
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` | Tanya persetujuan setiap tool (human-supervised) |
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 sesi (full history, bukan dump teks) |
53
- | `--timeout <ms>` | Hard deadline per run (default 900000; 0 = Infinity) |
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). **Operating mode**: `DISCUSS` = investigasi read-only, `PLAN` = analisis/planning, `BUILD` = implementasi (identitas internal `EXECUTE`). Persetujuan (`AUTO`/`ASK`) dipisah; tool availability mengikuti ceiling WorkMode. Lihat [TUI](repl.md) untuk `/work-mode` |
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
- Di TUI, **Tab** memutar WorkMode (`DISCUSS` → `PLAN` → `BUILD`) dan **Shift+Tab** meng-toggle PermissionMode (`AUTO` ↔ `ASK`). `/mode <AUTO|ASK>` mengubah persetujuan; `/work-mode <DISCUSS|PLAN|BUILD>` mengubah operating mode. Footer selalu menampilkan kedua lapis (`BUILD · AUTO`).
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
- | Kerja harian biasa | Default (`BUILD` + `AUTO`) — tulis/eksekusi/commit/delegasi jalan otonom bila authorized |
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 | Default `BUILD`+`AUTO`; isolasi tambahan `--sandbox docker` (atau OS) + `--budget` |
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 `.minicode/config.json`
102
-
103
- ```json
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": [{ "id": "my-provider", "baseUrl": "...", "apiKey": "...", "models": ["gpt-4o"] }],
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` (14 preset, lihat [Config & Provider](config-providers.md)).
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` | Rencana per sesi |
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
 
@@ -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,5 MiB)
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.584 KiB (3,5 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.
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
- Re-baseline dari 2,25 MiB disetujui owner (Quality Remediation Stage 8.1) karena batas lama ditetapkan saat payload runtime repo ±1.605 KiB, sedangkan sekarang runtime saja ±2.788 KiB — pertumbuhan itu fitur sah, bukan modul tak terjangkau (modul yang dipack tapi tak terjangkau dari entry point = 0). Saat runtime tumbuh melewati batas, **jangan** menaikkan lagi tanpa bukti baru + persetujuan owner: hitung dulu payload runtime (`git ls-tree -r -l HEAD -- src cli vendor`) dan bandwidth non-runtime yang bisa dipangkas (dokumen di luar closure tautan, `PLAN.md`/`AGENTS.md`), lalu usulkan angka barunya ke owner.
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 # vendor/minicore sinkron dengan ../minicore
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/ARCHITECTURE.html`.
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. Hanya seam aditif backward-compatible (`compactAsync`, `initialMessages`, `cwd`). Butuh primitif baru? Buktikan dulu tidak bisa sebagai Tool/Provider/Policy.
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`.
@@ -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` alias `EXECUTE` internal; flag menang atas env; nilai tak dikenal = BUILD/EXECUTE) |
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` (`eventId`, `timestamp`, `sessionId`, `turnId`, `correlationId`, `severity`, `status`, `payload`) dan **summary** terstruktur berversi di akhir — cukup untuk diparse pipeline tanpa screen-scraping. 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.
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:"auto"\|"plan"}` | 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) |
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` menulis envelope `minicode.output.v1` untuk lifecycle kanonik (`eventId`, `timestamp`, `sessionId`, `turnId`, `correlationId`, `severity`, `status`, `payload`) dan record terminal `summary` berversi (`error` = `{category, message, action?}`); teks model tetap record `{type:"text",delta}` terpisah. Setup failure selalu membawa satu baris summary `ok:false`.
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 "perbaiki lint di src/ lalu jalankan bun run lint" --json \
95
- --verify --budget 0.50 --budget-strict --max-steps 40
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
@@ -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
- bila ada, paket di-install (`npm install -g minicode-ai@latest`) lalu
67
- minicode restart sendiri ke versi baru — tanpa update manual. Berlaku hanya
68
- untuk salinan ter-install (checkout source tidak disentuh) dan tidak pernah
69
- memblokir: install gagal/offline = lanjut versi lama + pesan manual.
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
- > Model ancaman yang jujur: auto-update mengeksekusi kode dari registry
73
- > tanpa verifikasi tanda tangan client-side (attestasi Sigstore npm butuh
74
- > infrastruktur verifikasi di luar jangkauan CLI zero-dep — sudah diteliti,
75
- > bundelnya tak membawa identitas repo yang bisa dicek offline). Percayakan
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 update -g minicode-ai # manual, bila auto-update dimatikan
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 (37 bawaan + MCP dinamis `serverId.toolName`) |
10
- | **Tool scope** | `full` (semua 37) atau `explore` (subset read-only 12 tool) — flag `--tool-scope` |
11
- | **Permission mode** | Keputusan siapa yang memutuskan aksi: `auto / readonly / plan / allowlist / ask / allow-all` |
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 + TOCTOU `O_NOFOLLOW`); aktif bahkan `--allow-all` |
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` → `finalized`; sumber direktif verifikasi saat resume |
19
- | **Session** | Riwayat percakapan di `.minicode/sessions.db` (SQLite WAL); `--resume` lanjut full history |
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.0 |
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 hentikan penungguan, tapi tidak bunuh proses stdio maupun batalkan efek yang sudah terjadi.
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
 
@@ -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 full history (termasuk `toolCallId`/`name`); 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 history+turns).
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` → `finalized` (setelah turn durable di SQLite). Saat resume, dibaca **sebelum** seed kernel:
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
- - **Kapan terjadi:** otomatis saat tekanan konteks, sebelum batas jendela tercapai. Bila sesudah padat masih kurang, run gagal eksplisit (`context window exceeded`) — bukan sunyi.
60
- - **Yang dipertahankan:** ringkasan fakta — path file, signature, snippet penting, hasil tool, error, next steps. Ringkasan sebelumnya dibawa verbatim (tidak diringkas ulang) agar makna tak melenceng tiap siklus.
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.
@@ -1,21 +1,16 @@
1
1
  # Policy & Sandbox
2
2
 
3
- Siapa boleh apa: enam mode izin, penjaga perintah shell, dan isolasi eksekusi — plus batas jujurnya.
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
- ## 6 permission mode
5
+ ## Tiga sumbu kontrol
6
6
 
7
- `type PermissionMode = "auto"|"readonly"|"plan"|"allow-all"|"ask"|"allowlist"` (`permission.ts`). Keputusan data-driven per mode.
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
- | Mode | Semantik |
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; TOCTOU `O_NOFOLLOW` (`src/lib/safe-open.ts`: `resolveSafePath` untuk penulis, `safeOpenRead` untuk pembaca; POSIX-only, Windows pre-check).
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.