minicode-ai 0.14.2 → 0.14.5

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 (78) hide show
  1. package/README.md +34 -178
  2. package/cli/args.ts +10 -18
  3. package/cli/commands/acp.ts +20 -27
  4. package/cli/commands/daemon.ts +6 -7
  5. package/cli/commands/exec.ts +12 -10
  6. package/cli/commands.ts +6 -9
  7. package/cli/index.ts +30 -15
  8. package/cli/provider-manager.ts +1 -3
  9. package/cli/setup.ts +188 -143
  10. package/cli/tui.ts +15 -23
  11. package/docs/CONTROL-PLANE-MAP.md +145 -0
  12. package/docs/OUTPUT_EVENT_MODEL.md +1 -1
  13. package/docs/OUTPUT_PROTOCOL_SPEC.md +2 -2
  14. package/docs/OUTPUT_RENDERING_SPEC.md +7 -2
  15. package/docs/OUTPUT_UX_RULES.md +1 -1
  16. package/docs/README.md +14 -102
  17. package/docs/SUMMARY.md +53 -0
  18. package/docs/TERMINAL_CONTRACT.md +84 -51
  19. package/docs/UI_RENDER_PIPELINE.md +204 -0
  20. package/docs/agents.md +5 -5
  21. package/docs/architecture.md +23 -12
  22. package/docs/choosing-mode.md +7 -7
  23. package/docs/cli.md +22 -29
  24. package/docs/concepts.md +1 -1
  25. package/docs/config.md +10 -5
  26. package/docs/contributing.md +6 -6
  27. package/docs/environment.md +3 -1
  28. package/docs/exec.md +5 -5
  29. package/docs/glossary.md +8 -6
  30. package/docs/memory-sessions.md +7 -5
  31. package/docs/policy-sandbox.md +16 -14
  32. package/docs/quickstart.md +2 -2
  33. package/docs/repl.md +4 -3
  34. package/docs/security-model.md +14 -15
  35. package/docs/security.md +8 -29
  36. package/docs/skills.md +1 -1
  37. package/docs/tools.md +2 -2
  38. package/package.json +5 -3
  39. package/scripts/vendor-overlays/minicode-context.patch +109 -0
  40. package/src/app/provider-layer.ts +13 -1
  41. package/src/app/session.ts +231 -13
  42. package/src/config.ts +30 -3
  43. package/src/constants.ts +2 -0
  44. package/src/daemon/control.ts +1 -1
  45. package/src/mcp/server.ts +2 -3
  46. package/src/policy/compaction.ts +272 -16
  47. package/src/policy/context-window-catalog.ts +64 -0
  48. package/src/policy/context-window.ts +173 -0
  49. package/src/policy/context.ts +55 -3
  50. package/src/policy/pricing.ts +52 -0
  51. package/src/policy/ratelimit.ts +47 -18
  52. package/src/policy/usage.ts +15 -8
  53. package/src/policy/work-mode.ts +1 -1
  54. package/src/providers/guards.ts +61 -4
  55. package/src/providers/provision.ts +12 -3
  56. package/src/providers/router.ts +56 -23
  57. package/src/session/context-projection.ts +14 -0
  58. package/src/session/context-selector.ts +58 -20
  59. package/src/session/persistence.ts +1 -1
  60. package/src/task/model.ts +21 -70
  61. package/src/tools/task.ts +7 -0
  62. package/src/ui/footer.ts +131 -66
  63. package/src/ui/i18n/en.ts +0 -11
  64. package/src/ui/i18n/id.ts +0 -11
  65. package/src/ui/input/input.ts +2 -3
  66. package/src/ui/input/prompt-engine.ts +2 -5
  67. package/src/ui/screens/model-manager.ts +3 -10
  68. package/src/ui/screens/picker.ts +23 -40
  69. package/src/ui/screens/provider-manager.ts +12 -33
  70. package/src/ui/screens/wizard.ts +0 -1
  71. package/src/ui/tui/app.ts +10 -6
  72. package/src/ui/tui/transcript.ts +48 -8
  73. package/vendor/minicore/VENDOR.md +9 -5
  74. package/vendor/minicore/src/core/loop.ts +47 -12
  75. package/vendor/minicore/src/core/provider.ts +4 -0
  76. package/vendor/minicore/src/core/session.ts +14 -1
  77. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
  78. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
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
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
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
 
@@ -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
 
@@ -72,7 +74,7 @@ workspace yang sudah terjadi sebelum container dihentikan.
72
74
  ## Lapisan lain
73
75
 
74
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.
75
- - **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.
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.
76
78
  - **web_fetch/web_search**: redirect manual 5 hop + DNS pinning 30 dtk + body 2 MB.
77
79
  - **Secret scrubber**: `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` di-redact sebelum ke LLM (read_file/bash/grep) — tanpa whitelist kata.
78
80
  - **Config/allowlist**: atomic randomUUID tmp+rename + chmod 600. MCP serve curated tools + permission aktif.
@@ -20,7 +20,7 @@ minicode auth status # lihat kredensial + kapan kedaluwarsa
20
20
  ## 2. Prompt pertama (2 menit)
21
21
 
22
22
  ```bash
23
- minicode "buat http server hello world di server.ts" --verbose
23
+ minicode --work-mode BUILD "buat http server hello world di server.ts" --verbose
24
24
  ```
25
25
 
26
26
  Yang terjadi: model menerima system prompt berisi `# Environment` (cwd + platform) + repo-map ringkas, lalu loop ReAct `Thought → Action → Observation` sampai jawaban final atau batas (`--max-steps` default 50, `--timeout` default 15 menit).
@@ -38,7 +38,7 @@ minicode --interactive
38
38
  ## 3. Verify otomatis (2 menit)
39
39
 
40
40
  ```bash
41
- minicode --verify "fix bugs lalu typecheck"
41
+ minicode --work-mode BUILD --verify "fix bugs lalu typecheck"
42
42
  ```
43
43
 
44
44
  Sebelum agen jalan, baseline diuji dulu. Bila baseline sudah merah, catatan Health-Check ditempel ke prompt awal agar agen memperbaiki dulu. Setelah run, verify dijalankan; bila gagal, agen self-heal maks 3 siklus. Output error dibungkus fence agar tidak jadi prompt injection. Custom command via `MINICODE_VERIFY_CMD` atau `verifyCommand` di config.
package/docs/repl.md CHANGED
@@ -22,8 +22,8 @@ en. `/lang` tanpa argumen = tampilkan aktif. Semua string lewat kamus i18n
22
22
  | `/redo` | Terapkan ulang yang dibatalkan |
23
23
  | `/sessions` | Tanpa argumen = popup picker resume; `/sessions <id>` = langsung resume |
24
24
  | `/status` | Runtime + pemakaian & biaya **kumulatif sesi** |
25
- | `/mode [nama]` | Ganti permission (`auto`, `ask`, `plan`, `allowlist`); tanpa argumen = putar |
26
- | `/work-mode [DISCUSS\|PLAN\|EXECUTE]` | WorkMode = **lapis intent di atas** permission mode: `DISCUSS` read-only penuh, `PLAN` ceiling rencana, `EXECUTE` tanpa ceiling tambahan. Tanpa argumen = tampilkan mode aktif + usage; nilai invalid ditolak dan mode aktif tidak berubah. Terpisah dari `/mode` dan dari Tab/Shift+Tab (keduanya khusus permission mode). Di footer tampil `PLAN·auto` dsb. hanya saat WorkMode ≠ `EXECUTE`. |
25
+ | `/mode [AUTO\|ASK]` | Ganti pengawasan persetujuan; tanpa argumen = toggle AUTO/ASK |
26
+ | `/work-mode [DISCUSS\|PLAN\|BUILD]` | WorkMode membatasi cara agent bekerja. `DISCUSS` read-only, `PLAN` memakai ceiling rencana, `BUILD` tidak menambah ceiling (identitas internal `EXECUTE`). Tanpa argumen = tampilkan mode aktif + usage; nilai invalid ditolak dan mode aktif tidak berubah. Tab dan `/work-mode` mengubah WorkMode; Shift+Tab dan `/mode` mengubah PermissionMode. |
27
27
  | `/lang [en|id]` | Bahasa UI; tanpa argumen = tampilkan aktif |
28
28
  | `/init` | Buat `AGENTS.md` proyek ini |
29
29
  | `/copy [n]` | Salin `n` turn terakhir (default `1`, maksimal `10`) via OSC 52 |
@@ -42,7 +42,8 @@ Did-you-mean: typo `/sessoons` → `Did you mean /sessions?` (jarak ≤ 2).
42
42
  | Tombol | Fungsi |
43
43
  |---|---|
44
44
  | `enter` | Kirim prompt (di picker/form: pilih/simpan; kosong = batal di picker) |
45
- | `tab` / `shift+tab` | Putar mode izin (di form: pindah field) |
45
+ | `tab` | Putar WorkMode (`DISCUSS` → `PLAN` → `BUILD`) |
46
+ | `shift+tab` | Toggle PermissionMode (`AUTO` ↔ `ASK`) |
46
47
  | `↑` / `↓` | Riwayat prompt, atau navigasi item di picker/manager/form |
47
48
  | `pgup` / `pgdn` | Gulir transkrip satu halaman; dengan `shift`: setengah halaman (di picker/manager: gulir daftar) |
48
49
  | `mouse drag` | Select teks transkrip; `Ctrl+C` menyalin selection app-level |
@@ -21,20 +21,19 @@ Permission → Jail → Bash Guard → Argument Validation → Executor → Jour
21
21
  | **Bash Guard** | Perintah shell dinormalisasi dulu (buang quote/wrapper/variabel sederhana), baru diperiksa polanya. Menolak env-dump, exfiltrasi upload, interpreter inline, destruksi luas. |
22
22
  | **Argument Validation** | Skema argumen divalidasi kernel sebelum eksekusi; argumen invalid ditolak tanpa efek. |
23
23
  | **Executor** | Menjalankan yang lolos: read paralel, write dibatasi konkurensinya, abort-aware, output dipotong dengan penanda (tak pernah diam-diam). |
24
- | **Journal / Recovery** | Tiap mutasi dicatat `pending` → `committed`/`failed` → `finalized`. Resume tak pernah mengulang buta (lihat [Recovery](#recovery)). |
24
+ | **Journal / Recovery** | Tiap mutasi dicatat sebagai `pending` lalu `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn durable. Resume tak pernah mengulang buta (lihat [Recovery](#recovery)). |
25
25
 
26
- ## Permission Modes
26
+ ## Mode dan akses
27
27
 
28
- | Mode | Boleh | Tidak boleh | Approval |
29
- |---|---|---|---|
30
- | `auto` (default) | Baca + tulis file terjail + bash aman + memori/todo | Gated tools tanpa persetujuan | Sekali per tool gated (TTY); non-TTY = tolak |
31
- | `ask` | Sama seperti `auto` | Tanpa jawaban allow | Tiap tool non-sepele |
32
- | `readonly` | 18 tool baca di gerbang izin (model melihat 12) | Mutasi apa pun, bash, commit, delegasi | Tidak perlu (tak ada efek) |
33
- | `plan` | Baca + `todo_write` + `delegate_task` (anak dipaksa read-only) + `submit_result` | Tulis file, bash, git, memori | Tidak perlu |
34
- | `allowlist` | Bash pola aman + tulis terjail | Shell di luar pola, tool gated | Tidak perlu |
35
- | `allow-all` | Semua tool | Bash berbahaya, path di luar jail | Tidak perlu |
28
+ Pilihan yang terlihat oleh operator dipisah menjadi tiga sumbu:
36
29
 
37
- PENTING: **`allow-all` bukan akses host tanpa batas.** Jail path dan bash-guard tetap aktif di mode ini. Yang dimatikan hanya gerbang persetujuan, bukan batas filesystem dan pola perintah.
30
+ | Sumbu | Nilai | Dampak |
31
+ |---|---|---|
32
+ | **WorkMode** | `DISCUSS`, `PLAN`, `BUILD` (`EXECUTE` internal) | Membatasi ruang kerja agent. `DISCUSS` read-only; `PLAN` dapat menulis artefak rencana; `BUILD` tidak menambahkan ceiling. WorkMode hanya mempersempit akses. |
33
+ | **PermissionMode** | `AUTO`, `ASK` | `AUTO` menjalankan capability yang sudah diotorisasi tanpa persetujuan rutin; `ASK` meminta persetujuan untuk pemanggilan yang digate. `ask_user` ditolak di `AUTO`. |
34
+ | **Tool Access Policy** | kebijakan capability dan profil akses warisan | Menentukan tools yang tersedia. `readonly`, `plan`, `allowlist`, dan `allow-all` tetap menjadi identitas internal/kompatibilitas untuk batas akses, bukan mode persetujuan tambahan. |
35
+
36
+ **Profil `allow-all` tetap terbatas.** Path jail, penolakan state milik runtime, bash-guard, dan validasi argumen tetap berlaku; profil ini tidak memberi akses host tanpa batas. Detail implementasi dan opsi CLI ada di [Policy & Sandbox](policy-sandbox.md).
38
37
 
39
38
  ## Trust Boundaries
40
39
 
@@ -44,9 +43,9 @@ PENTING: **`allow-all` bukan akses host tanpa batas.** Jail path dan bash-guard
44
43
  | Output model | Tak dipercaya untuk klaim | Teks/keputusan model bisa salah; bukti (hasil tool, test, HEAD) yang menentukan |
45
44
  | Hasil tool | Data | Dibaca model sebagai fakta observasi, bukan instruksi baru |
46
45
  | Data repository (kode, AGENTS.md, MEMORY, skill) | Data | Bisa berisi instruksi injeksi; system prompt menandainya tak-terpercaya |
47
- | Server MCP | External capability | Efek di sisi server arbitrer dan tak terlihat; tiap pemanggilan di-gate; pembatalan tak membatalkan efek yang sudah terjadi |
46
+ | Server MCP | External capability | Efek di sisi server arbitrer dan tak terlihat; persetujuan mengikuti mode dan authorization; pembatalan tak membatalkan efek yang sudah terjadi |
48
47
  | Provider / network | External | Prompt dan hasil melewati provider yang Anda pilih; tak ada telemetri/analitik dari Minicode sendiri |
49
- | Child agent | Terisolasi | Memori, sinyal, budget, dan jurnal sendiri; tanpa MCP/commit/tulis-memori/nesting |
48
+ | Child agent | Terisolasi | Memori, sinyal, budget, dan jurnal sendiri; tool scope mengikuti kebijakan delegasi dan WorkMode parent (lihat [Sub-Agents & Tasks](agents.md)) |
50
49
  | Local config (`.minicode/config.json`) | Tak dipercaya default | Diabaikan kecuali `--allow-local-config`; repo clone-an tak bisa men-spawn server |
51
50
  | Skills / memory tersimpan | Data | Dibaca sebagai konteks, bukan kebijakan |
52
51
 
@@ -65,11 +64,11 @@ Catatan jujur: operasi itu tetap BISA diketik lewat `bash` (tunduk pada bash-gua
65
64
  Setiap mutasi meninggalkan bukti, bukan janji (disebut *mutation journal* di kode: `src/session/journal.ts`):
66
65
 
67
66
  ```
68
- intent (sebelum eksekusi) → committed/failed (sesudahnya) → finalized (turn durable)
67
+ intent pending → committed/failed/unknown → finalisasi cakupan turn durable
69
68
  ```
70
69
 
71
70
  - `committed` yang turn-nya hilang → **tidak diulang**; model diberi catatan narasi.
72
- - `pending`/`failed` → direktif verifikasi; **dilarang redo buta**.
71
+ - `pending`/`failed`/`unknown` → direktif verifikasi; **dilarang redo buta**.
73
72
  - Klaim sukses pihak ketiga (MCP) diperlakukan sebagai "kata server", wajib baca-balik bila penting.
74
73
 
75
74
  Kejujuran yang disengaja: crash ambiguity TETAP MUNGKIN (filesystem dan database tak bisa commit atomik bersama). Yang dijamin adalah: ambiguitas selalu diperlakukan sebagai ambigu — diverifikasi dulu, tidak diasumsikan sukses maupun gagal.
package/docs/security.md CHANGED
@@ -5,36 +5,15 @@
5
5
  1. **Fail-closed di jalur tak pasti**: tool tanpa backend tersedia menolak (`code_run`), sandbox yang diminta tapi tidak tersedia tidak pura-pura aman (warn + `allowlist`), provider OAuth yang belum login dibuang dari daftar, auth non-TTY fail-fast.
6
6
  2. **Ukur, bukan klaim**: bash-guard divalidasi korpus manual pola serangan + perintah sah dan fuzz kombinatorial ber-seed — jalankan `bun run gate:bash` dan `bun run extreme:fuzz` untuk angka terkini (exit 0 = 0 bypass / 0 over-block).
7
7
  3. **Teks eksternal = tidak terpercaya**: output tool, MCP, web, bahkan output verify dibungkus fence; `sanitizeAnsi` menyaring escape ANSI dari teks model/tool sebelum render.
8
- 4. **Permission mengontrol pemanggilan, bukan capability**: satu approval = satu pasangan server+tool+args (MCP); capability di balik server tak bisa diketahui statis.
8
+ 4. **Permission mengontrol pemanggilan, bukan capability**: di ASK, satu approval hanya mencakup pasangan server+tool+args (MCP); capability di balik server tak bisa diketahui statis.
9
9
 
10
- ## 6 permission mode
10
+ ## Mode dan akses
11
11
 
12
- `auto` (default) · `readonly` (18 tool read-only di gerbang izin; model melihat 12) · `plan` (readonly + todo + delegate read-only) · `allowlist` (bash pola aman) · `ask` (prompt tiap tool) · `allow-all` (semua — tetap tolak bash berbahaya, path jail tetap aktif). Putar via Shift+Tab (siklus 5: `allow-all` dilewati), `/mode`, atau flag `--plan/--allowlist/--ask/--allow-all`. Detail per mode di [Policy & Sandbox](policy-sandbox.md).
12
+ Kontrol mode punya tiga sumbu: **WorkMode** (`DISCUSS`/`PLAN`/`BUILD`) membatasi cara kerja agent; **PermissionMode** (`AUTO`/`ASK`) menentukan kapan dibutuhkan persetujuan manusia; **Tool Access Policy** menentukan capability yang tersedia. Nilai internal `readonly`, `plan`, `allowlist`, dan `allow-all` masih ada untuk batas akses dan kompatibilitas, tetapi bukan empat mode pengawasan tambahan. Hard deny path jail, owned-state, dan bash-guard tetap berlaku. Detail kombinasi dan interface ada di [Memilih Mode](choosing-mode.md) dan [Policy & Sandbox](policy-sandbox.md).
13
13
 
14
14
  ## Lapisan perlindungan bash
15
15
 
16
- 1. **Bash-guard ternormalisasi** (`src/policy/bash-guard.ts`) — quote pemisah kata dibuang dan assignment sederhana disubstitusi **sebelum** pemeriksaan. Ini menutup kelas bypass, bukan pola individual:
17
-
18
- | Dulu lolos | Kenapa | Sekarang |
19
- |---|---|---|
20
- | `cat .e""nv` | regex melihat `.e""nv`, shell membaca `.env` | ditolak |
21
- | `X=.env; cat $X` | regex tak pernah melihat `.env` | ditolak |
22
- | `p=python3; $p -c 1` | regex tak melihat `python3 -c` | ditolak |
23
- | `node --eval "1"` | hanya `-e` yang di-regex | ditolak |
24
- | `env`, `set`, `export -p` | hanya `printenv` yang diblok | ditolak |
25
- | `curl -F file=@~/.ssh/id_rsa` | tak ada aturan upload | ditolak |
26
- | `bash <(curl x)` | tak ada aturan process substitution | ditolak |
27
- | `rm -rf ..`, `rm --recursive --force /`, `rm -rf /; :` | pola lama hanya kenal `/` dan `~` | ditolak |
28
- | `command env`, `nice env`, dkk. (wrapper) | deteksi env-dump ter-anchor ke awal | ditolak via `stripCommandWrappers` (buang wrapper berlapis) |
29
- | `echo x > ..\evil` (redirect keluar workspace) | allowlist `echo *` + guard tanpa aturan redirect | ditolak via `findRedirectTargets` (target di-resolve ke cwd; heredoc/fd/`/dev/null` dikecualikan) |
30
- | `echo x > "%TEMP%\evil"` (redirect + ekspansi env) | cek statis melihat literal `%TEMP%\…` di dalam cwd; cmd.exe mengekspansi SETELAH cek | ditolak: target berpola `%NAMA%` tak bisa dipastikan aman (red-team eksternal). `%` tunggal (`100%.txt`) tetap lolos |
31
- | `py -c …`, `python3.14 -c …` (launcher/versi) | regex hanya kenal `python|python2|python3|pypy` | ditolak via `pyw?|python[\d.]*|pypy[\d.]*` |
32
- | `type ..\..\..\windows\system32\config\sam` (baca hive SAM) | pola kredensial POSIX-sentris (`/etc/shadow` dkk, tanpa padanan Windows) | ditolak: `system32\config\(sam|system|security|software|default)` + `ntds.dit` (anchor segmen, case-insensitive); `reg save|export` hive + `vssadmin create|delete shadow` + `ntdsutil` ditolak eksplisit (`reg query`, `vssadmin list`, `system.txt` biasa tetap lolos) |
33
- | `write_file .minicode/test-write.txt` (state via nama tak terdaftar) | jail `.minicode/` berbasis daftar-nama | ditolak: kunci penuh segmen `.minicode/` untuk tool tulis (satu-satunya pengecualian: restore `.minicode/.trash/` → workspace) |
34
- | baca via hardlink ke luar workspace | `realpath` tak melihat hardlink (semua nama setara) | ditolak bila `nlink > 1` pada handle yang dibuka (fstat, bebas race). Tulis aman by-design (atomic replace memutus hardlink) |
35
- | `type .e^nv`, `ty^pe .env` (escape caret cmd.exe) | guard mencocokkan nama LITERAL, sementara cmd.exe melepas `^` di luar kutip ganda sebelum eksekusi — satu caret memindahkan perintah dari "ditahan" ke "lolos" | ditolak: `stripCaretEscapes` berjalan sebelum semua aturan nama/jail (audit 2026-09-20, temuan F1); caret di dalam kutip ganda tidak disentuh (`echo "a^b"` tetap sah). Trade-off jujur: di POSIX caret bukan escape, jadi `cat .e^nv` ikut ditolak (fail-closed; berkas bernama `.e^nv` praktis tidak ada) |
36
- | `type %USERPROFILE%\notes.txt` (argumen PEMBACA + ekspansi env) | hanya target redirect yang dianggap "tak bisa dipastikan"; argumen pembaca di-`resolve()` sebagai jalur relatif DI DALAM cwd | ditolak: aturan `%NAMA%` kini simetris untuk argumen pembaca (temuan F2). `%` tunggal (`100%.txt`) tetap lolos |
37
- | `for /f %i in (.env) do @echo %i` (pembaca bawaan cmd.exe) | `for` adalah loop, bukan utilitas → tidak ada di `READERS`, sehingga target berkasnya tak diperiksa sama sekali | ditolak: set berkas `for /f … in (…)` diekstrak (`forFileSets`) dan diperiksa seperti argumen pembaca (temuan F3) |
16
+ 1. **Bash-guard ternormalisasi** (`src/policy/bash-guard.ts`) menormalisasi command sebelum aturan diterapkan. Tabel bypass termasuk redirect, ekspansi env Windows, hardlink, escape caret, dan pembaca `for /f` ada di [Policy & Sandbox](policy-sandbox.md), satu sumber contoh. `bun run gate:bash` dan `bun run extreme:fuzz` mengukur regresi.
38
17
 
39
18
  2. **Allowlist** (`--allowlist`, dan default bila tanpa sandbox OS): hanya bentuk read/build — `git status/diff/log/branch/show`, `bun test/run/x tsc`, `npm run/exec`, `npx`, `ls dir cat type head tail wc grep rg find which echo pwd`. Tulis via shell ditahan; pakai `write_file`/`edit` yang ter-jail. `npm exec`/`npx`/`bun run`/`bun x` tak boleh ekspansi shell/redirection. `git --no-index/--exec-path/--upload-pack/--receive-pack`, transport `ext::`, dan `GIT_EXTERNAL_DIFF`/`GIT_CONFIG_*` inline ditolak guard (git sebagai pelarian jail).
40
19
  3. **Path jail** realpath-based + symlink check; pembaca membuka target canonical, memakai `O_NOFOLLOW` pada POSIX, lalu mencocokkan `dev+ino` antara stat sebelum open dan handle setelah open (termasuk Windows). `.env`/`.git/config`/`node_modules`/hive Windows (`system32\config\sam|system|security|software`, `ntds.dit`) deny; berlaku bahkan `--allow-all`.
@@ -51,7 +30,7 @@ tidak mewarisi konfigurasi tersebut.
51
30
 
52
31
  - Output verify dibungkus fence agar instruksi di error build tidak diikuti model.
53
32
  - `mcp_read`/`mcp_prompt` di-gate meski read-only — konten pihak ketiga langsung ke konteks = jalur injection; "read-only ≠ aman".
54
- - Secret scrubber meredaksi `sk-`, `ghp-`, `AKIA`, PEM, JWT, Bearer, `api_key=...` sebelum teks ke LLM (read_file/bash/grep), tanpa whitelist kata.
33
+ - Secret scrubber meredaksi `sk-`, `ghp_`, `AKIA`, PEM, JWT, Bearer, `api_key=...` sebelum teks ke LLM (read_file/bash/grep), tanpa whitelist kata.
55
34
  - Bypass korpus + fuzz: `bun run gate:bash`, `bun run extreme:fuzz` (`--seed` untuk reproduksi). Batas jujur: analisis statis atas bahasa Turing-complete; `$(curl …)` dinamis perlu sandbox OS/docker.
56
35
 
57
36
  ## Batas kepercayaan file lokal (trust model)
@@ -81,17 +60,17 @@ provider model pihak ketiga.
81
60
  ## Config lokal & supply chain
82
61
 
83
62
  - Config lokal `.minicode/config.json` + allowlist **diabaikan secara default** — repo clone-an tidak bisa men-spawn MCP, menyedot prompt, atau memasang hook. Percayai dengan `--allow-local-config`.
84
- - Server MCP terdaftar tidak mendapat wildcard auto-allow; tiap tool bertitik di-gate sekali per pasangan server+tool+args; `[a] Always` persist ke allowlist.
63
+ - Server MCP terdaftar tidak mendapat wildcard auto-allow. Capability tetap harus diotorisasi; di ASK pemanggilan yang digate meminta persetujuan per pasangan server+tool+args, sedangkan AUTO menjalankan capability authorized tanpa prompt rutin. `[a] Always` menyimpan cakupan yang disetujui ke allowlist.
85
64
  - Config/allowlist/auth ditulis atomik + chmod 600; token OAuth terpisah di `~/.minicode/auth.json` (bukan config yang rawan ter-commit).
86
65
  - `mcp serve` stdio-only (tanpa mode HTTP → tanpa permukaan jaringan), curated tools, permission aktif; `--all-tools` opt-in operator.
87
66
 
88
67
  ## Checkpoint & recovery
89
68
 
90
- Setiap turn checkpoint shadow-git + recovery journal `.minicode/journal-<sesi>.jsonl` (`pending` → `committed` → `finalized`). Saat resume: `committed` yang turn-nya hilang tidak diulang; `pending`/`failed` → direktif verifikasi, dilarang redo buta; `committed` MCP = external-acknowledged wajib baca-balik. Detail di [Memory & Sessions](memory-sessions.md).
69
+ Setiap turn checkpoint shadow-git + recovery journal `.minicode/journal-<sesi>.jsonl` (`pending` → `committed`/`failed`/`unknown`; finalisasi menandai cakupan turn durable). Saat resume: `committed` yang turn-nya hilang tidak diulang; `pending`/`failed`/`unknown` → direktif verifikasi, dilarang redo buta; `committed` MCP = external-acknowledged wajib baca-balik. Detail di [Memory & Sessions](memory-sessions.md).
91
70
 
92
71
  ## Lanjut
93
72
 
94
73
  - [Security Model](security-model.md) — rantai eksekusi, trust boundary, dan limitasi dalam satu halaman.
95
- - [Policy & Sandbox](policy-sandbox.md) — 6 mode + detail guard.
74
+ - [Policy & Sandbox](policy-sandbox.md) — mode, tool access policy, dan detail guard.
96
75
  - [Kontrak Terminal](terminal.md) — kenapa warna di-gate TTY.
97
76
  - [Otomasi & CI](exec.md) — batasan agent di CI (fail-closed non-TTY).
package/docs/skills.md CHANGED
@@ -45,4 +45,4 @@ Hooks global + lokal di-merge dari allowlist secara atomik (chmod 600). Karena h
45
45
 
46
46
  - [TUI](repl.md) - dropdown + slash command.
47
47
  - [Config](config.md) — lokasi file & skema config.
48
- - [Tools](tools.md) — referensi 37 tool yang bisa dipanggil skill.
48
+ - [Tools](tools.md) — capability yang tersedia untuk skill.