minicode-ai 0.13.1 → 0.14.1

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 (83) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -0
  4. package/cli/args.ts +66 -5
  5. package/cli/commands/acp.ts +18 -3
  6. package/cli/commands/daemon.ts +114 -19
  7. package/cli/commands/exec.ts +104 -7
  8. package/cli/commands/mcp.ts +66 -5
  9. package/cli/commands/memory.ts +46 -14
  10. package/cli/commands.ts +5 -0
  11. package/cli/index.ts +51 -16
  12. package/cli/setup.ts +380 -32
  13. package/cli/tui.ts +115 -50
  14. package/docs/TERMINAL_CONTRACT.md +91 -24
  15. package/docs/agents.md +3 -3
  16. package/docs/choosing-mode.md +20 -13
  17. package/docs/cli.md +12 -11
  18. package/docs/environment.md +4 -3
  19. package/docs/memory-sessions.md +5 -0
  20. package/package.json +2 -1
  21. package/src/app/session.ts +159 -35
  22. package/src/app/tool-layer.ts +69 -62
  23. package/src/daemon/approvals.ts +25 -1
  24. package/src/daemon/client.ts +51 -1
  25. package/src/daemon/control.ts +8 -0
  26. package/src/daemon/protocol.ts +47 -1
  27. package/src/daemon/server.ts +45 -9
  28. package/src/daemon/subscription.ts +25 -1
  29. package/src/daemon/telemetry.ts +4 -0
  30. package/src/hooks/run.ts +5 -1
  31. package/src/mcp/client.ts +349 -90
  32. package/src/mcp/http-transport.ts +7 -0
  33. package/src/mcp/transport.ts +5 -0
  34. package/src/memory/files.ts +69 -3
  35. package/src/memory/vector.ts +556 -160
  36. package/src/policy/approval-binding.ts +199 -0
  37. package/src/policy/context.ts +20 -1
  38. package/src/policy/executor.ts +44 -5
  39. package/src/policy/permission.ts +317 -41
  40. package/src/policy/tool-contract.ts +94 -0
  41. package/src/policy/usage.ts +3 -1
  42. package/src/policy/work-mode.ts +99 -17
  43. package/src/presentation/adapter.ts +157 -7
  44. package/src/presentation/events.ts +173 -1
  45. package/src/presentation/model.ts +37 -0
  46. package/src/presentation/projection.ts +107 -18
  47. package/src/presentation/reducer.ts +134 -10
  48. package/src/sandbox/os.ts +18 -1
  49. package/src/session/persistence.ts +153 -11
  50. package/src/task/store.ts +43 -3
  51. package/src/tools/memory.ts +70 -10
  52. package/src/tools/task.ts +7 -1
  53. package/src/tools/todo.ts +14 -4
  54. package/src/ui/approval/prompt.ts +52 -7
  55. package/src/ui/assistant/simple.ts +160 -57
  56. package/src/ui/contract.ts +46 -0
  57. package/src/ui/footer.ts +31 -17
  58. package/src/ui/i18n/en.ts +12 -3
  59. package/src/ui/i18n/id.ts +12 -3
  60. package/src/ui/render/collapse.ts +24 -52
  61. package/src/ui/render/detail.ts +14 -9
  62. package/src/ui/render/errors.ts +8 -0
  63. package/src/ui/render/reasoning.ts +13 -8
  64. package/src/ui/session-state.ts +243 -0
  65. package/src/ui/tui/app.ts +13 -7
  66. package/src/ui/tui/transcript.ts +271 -30
  67. package/vendor/minicore/src/core/budget.ts +25 -25
  68. package/vendor/minicore/src/core/compact.ts +75 -75
  69. package/vendor/minicore/src/core/errors.ts +59 -59
  70. package/vendor/minicore/src/core/events.ts +73 -73
  71. package/vendor/minicore/src/core/executor.ts +139 -139
  72. package/vendor/minicore/src/core/history.ts +31 -31
  73. package/vendor/minicore/src/core/index.ts +41 -41
  74. package/vendor/minicore/src/core/loop.ts +355 -355
  75. package/vendor/minicore/src/core/permission.ts +22 -22
  76. package/vendor/minicore/src/core/provider.ts +39 -39
  77. package/vendor/minicore/src/core/recovery.ts +35 -35
  78. package/vendor/minicore/src/core/session.ts +327 -327
  79. package/vendor/minicore/src/core/snapshot.ts +146 -146
  80. package/vendor/minicore/src/core/tokens.ts +107 -107
  81. package/vendor/minicore/src/core/tool.ts +115 -115
  82. package/vendor/minicore/src/core/types.ts +50 -50
  83. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
package/docs/cli.md CHANGED
@@ -24,6 +24,7 @@ Semua cara menjalankan Minicode: interaktif, sekali jalan, pipe, dan otomasi CI
24
24
  | `minicode skills list` | Daftar skill terpasang |
25
25
  | `minicode sessions list` | Riwayat sesi |
26
26
  | `minicode memory status [--json]` | Statistik vector RAG (rows, size, hit-rate) |
27
+ | `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only; tidak menghapus) |
27
28
  | `minicode doctor [--json]` | Diagnosis lokal |
28
29
  | `minicode mcp serve` | Ekspos minicode sebagai MCP server |
29
30
 
@@ -42,10 +43,10 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
42
43
  | `--budget <usd>` | Batas biaya sesi; warn 80%, exit/break bila lewat; cost tak dikenal + pemakaian = over (fail-closed default) |
43
44
  | `--budget-strict` | Penegasan eksplisit fail-closed di atas (back-compat) |
44
45
  | `--tool-scope <s>` | `full` (default) \| `explore` = subset read-only 12 tool |
45
- | `--plan` | Read-only plan mode |
46
- | `--allowlist` | Bash hanya perintah aman |
47
- | `--ask` | Tanya persetujuan setiap tool |
48
- | `--allow-all` | Nonaktifkan semua sandbox (path jail tetap aktif) |
46
+ | `--plan` | **Deprecated** — alias untuk `--work-mode PLAN` (read-only planning) |
47
+ | `--allowlist` | Bash hanya perintah aman (tool-access policy warisan) |
48
+ | `--ask` | Tanya persetujuan setiap tool (human-supervised) |
49
+ | `--allow-all` | Profil akses privileged (path jail + bash-guard tetap aktif) |
49
50
  | `--model <name>` | Override model (`providerId::model` paksa provider) |
50
51
  | `--provider <id>` | Paksa provider id agnostik |
51
52
  | `--resume <id>` | Lanjutkan sesi (full history, bukan dump teks) |
@@ -55,21 +56,21 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
55
56
  | `--max-steps <n>` | Batas langkah tool (default 50) |
56
57
  | `--context-window <n>` | Ukuran jendela konteks (token) |
57
58
  | `--session <id>` | ID sesi (default random, disanitasi) |
58
- | `--work-mode <m>` | `DISCUSS` \| `PLAN` \| `EXECUTE` (default). **Lapis intent di atas** permission mode: `DISCUSS` = read-only penuh, `PLAN` = hanya tool rencana, `EXECUTE` = tanpa ceiling tambahan. Tidak pernah memperluas kewenangan permission mode; permission mode tetap yang memutuskan allow/deny per tool. Lihat [TUI](repl.md) untuk `/work-mode` (aksi operator saat sesi berjalan) |
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` |
59
60
  | `--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` |
60
61
  | `--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` |
61
62
 
62
- Di TUI, **Shift+Tab** memutar permission (`auto` → `ask` → `plan` → `allowlist`) dan benar-benar mengubah keputusan, bukan label. Di baris kosong, **Tab** juga memutar mode (`auto` → `ask` → `plan` → `allowlist`). Shift+Tab **tidak** memutar WorkMode — itu lapis intent terpisah (`/work-mode`).
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`).
63
64
 
64
65
  ## Kapan memakai apa
65
66
 
66
67
  | Tujuan | Pakai |
67
68
  |---|---|
68
- | Kerja harian biasa | Default (`auto`) — tulis aman langsung jalan, yang berisiko minta izin |
69
- | Repo asing / perintah belum dipahami | `--ask`, jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
70
- | Review tanpa eksekusi | `--plan` (+ `--tool-scope explore` bila ingin subset baca 12 tool) |
71
- | CI tanpa manusia | `exec --json` + `--budget`/`--max-steps`; hindari prompt yang butuh klarifikasi |
72
- | Otonom penuh di mesin sendiri | `--allow-all` + `--sandbox docker` (atau OS) + `--budget` |
69
+ | Kerja harian biasa | Default (`BUILD` + `AUTO`) — tulis/eksekusi/commit/delegasi jalan otonom bila authorized |
70
+ | Repo asing / perintah belum dipahami | `--ask` (`BUILD` + `ASK`), jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
71
+ | Review/analisis tanpa eksekusi | `--work-mode PLAN` (atau `--work-mode DISCUSS` untuk investigasi read-only murni) |
72
+ | 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` |
73
74
  | Model mahal tak terkendali | `--budget 0.50` + `--budget-strict` + `pricing sync` |
74
75
 
75
76
  Detail alasan tiap mode di [Memilih Mode](choosing-mode.md).
@@ -12,10 +12,10 @@ 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
- | `MINICODE_PLAN` | `1` → mode plan (tanpa `--plan`) |
16
- | `MINICODE_PERMISSION` | `allowlist` → mode permission |
15
+ | `MINICODE_PLAN` | `1` → alias warisan `--work-mode PLAN` (tanpa `--plan`) |
16
+ | `MINICODE_PERMISSION` | `allowlist` → tool-access policy bash (profil warisan) |
17
17
  | `MINICODE_TOOL_SCOPE` | `explore` → subset read-only 12 tool (sama `--tool-scope explore`) |
18
- | `MINICODE_WORK_MODE` | `DISCUSS` \| `PLAN` \| `EXECUTE` → work mode (lapis intent di atas permission mode; sama `--work-mode`; flag menang atas env; nilai tak dikenal = EXECUTE) |
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) |
19
19
  | `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
20
  | `MINICODE_SESSION_TTL_DAYS` | TTL sesi (default 30; `0` = selamanya) |
21
21
  | `MINICODE_HOME` | Override home untuk DB lokal/global (sessions + vector); default `~` |
@@ -29,6 +29,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
29
29
  | Variabel | Fungsi |
30
30
  |---|---|
31
31
  | `MINICODE_LANG` | `en`/`id` → bahasa UI (prioritas lengkap di kontrak terminal §i18n: `/lang` > env ini > state.json > locale OS > en) |
32
+ | `MINICODE_DEBUG_BUS` | `1` → cetak satu baris diagnosis event bus per turn ke stderr (`src/ui/runtime/bus-debug.ts`; diagnostik saja, bukan perilaku) |
32
33
  | `MINICODE_DEBUG_STARTUP` | `1` → cetak durasi tiap tahap setup sesi ke stderr (diagnosis startup lambat; diagnostik saja, bukan perilaku) |
33
34
  | `MINICODE_MINIMIZE_ANSWER` | set (nilai apa pun) → JANGAN auto-minimize section jawaban model (nilai unset = minimize default) |
34
35
  | `MINICODE_KEYSTORE_DISABLE` | `1` → matikan keystore OS seluruhnya (jatuh ke penyimpanan file; untuk CI/headless yang tak punya keychain/DPAPI) |
@@ -13,8 +13,13 @@ Retensi hierarkis per kategori: `fact`/`decision`/`preference` 180 hari, `summar
13
13
 
14
14
  ```bash
15
15
  minicode memory status [--json] # rows, bytes DB/WAL/SHM, sebaran model/dim, hit-rate RAG
16
+ minicode memory reconcile [--json] [--cwd PATH] # samakan vector.db <-> MEMORY.md
16
17
  ```
17
18
 
19
+ `reconcile` mengadopsi entri vector-only ke `MEMORY.md` dan menambah baris file-only
20
+ ke index (tidak menghapus fakta); jalankan bila `write_memory` melaporkan
21
+ "vector index unavailable".
22
+
18
23
  Auto-simpan: summary persist + snippet verify sukses. Opt-out `MINICODE_AUTO_MEMORY=0`.
19
24
 
20
25
  Embedding: default `text-embedding-3-small` (`MINICODE_EMBED_MODEL`). Dim-mismatch → warn sekali + fallback keyword-only. FTS5 (`porter unicode61`) + trigger sync; fallback LIKE bila MATCH gagal.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.13.1",
3
+ "version": "0.14.1",
4
4
  "description": "Coding agent CLI built on the frozen MiniCore runtime — tools, MCP, LSP, sandbox, shadow-git checkpoints",
5
5
  "type": "module",
6
6
  "private": false,
@@ -109,6 +109,7 @@
109
109
  "dev": "bun cli/index.ts",
110
110
  "bench": "bun bench/runner.ts",
111
111
  "bench:smoke": "bun bench/runner.ts --fake",
112
+ "bench:render": "bun scripts/bench-render.ts",
112
113
  "gate:eval": "bun bench/eval-gate.ts",
113
114
  "audit:harness": "bun bench/harness-audit.ts",
114
115
  "bench:runs": "bun bench/runner.ts --runs 2",
@@ -1,10 +1,18 @@
1
+ import { resolve } from "node:path"
1
2
  import type { RecoveryAction } from "#minicore/core/errors.ts"
2
3
  import { ProviderError } from "#minicore/core/errors.ts"
3
- import type { PermissionHandler, Session, SessionConfig } from "#minicore/core/index.ts"
4
+ import type {
5
+ ModelProvider,
6
+ PermissionHandler,
7
+ Session,
8
+ SessionConfig,
9
+ } from "#minicore/core/index.ts"
4
10
  import { createSession as createCoreSession } from "#minicore/core/index.ts"
5
11
  import { defaultRecoveryPolicy } from "#minicore/core/recovery.ts"
6
12
  import { estimateMessages, estimateSystem, estimateTools } from "#minicore/core/tokens.ts"
7
13
  import { LIMITS } from "../constants.ts"
14
+ // [Area B · PROMPT 06] Binding persetujuan ↔ operasi yang dieksekusi.
15
+ import { ApprovalBindingStore, verifyApprovalBinding } from "../policy/approval-binding.ts"
8
16
  import {
9
17
  buildSystemPrompt,
10
18
  createCalibratedEstimator,
@@ -12,6 +20,7 @@ import {
12
20
  } from "../policy/context.ts"
13
21
  import { parallelExecutor } from "../policy/executor.ts"
14
22
  import {
23
+ canonicalArgsHash,
15
24
  createNoProgressDetector,
16
25
  type NoProgressDetector,
17
26
  type NoProgressOptions,
@@ -71,6 +80,38 @@ export type WorkModeControl = {
71
80
  getWorkMode(): WorkMode
72
81
  }
73
82
 
83
+ /**
84
+ * Guidance system-prompt ber-keyed WorkMode (lapis intent), BUKAN PermissionMode.
85
+ *
86
+ * DISCUSS = investigasi baca-saja yang berorientasi diskusi: model membaca,
87
+ * mencari, dan bernalar, lalu MENYAJIKAN temuan/opsi/trade-off untuk didiskusikan
88
+ * dengan user — bukan menulis atau mengeksekusi apa pun. PLAN = investigasi/
89
+ * planning formal dengan prompt SENDIRI (independen dari `planHint` milik
90
+ * PermissionMode di bawah; lapisan intent ≠ lapisan permission). EXECUTE = tidak
91
+ * menambah apa pun (identitas).
92
+ *
93
+ * Ini *guidance* (behavior), bukan enforcement — enforcement tetap milik ceiling
94
+ * handler `work-mode.ts`. Diekspor agar teruji langsung (pola repo pure/export).
95
+ */
96
+ export function workModeHint(workMode: WorkMode): string {
97
+ if (workMode === "DISCUSS") {
98
+ return (
99
+ "\n\nDISCUSS MODE: You are in read-only investigation and discussion mode. " +
100
+ "Do NOT modify files, run bash, or use write/edit tools. " +
101
+ "Read, search, and reason — investigate the question, then discuss findings, options, and trade-offs with the user. " +
102
+ "Do not implement or execute any change."
103
+ )
104
+ }
105
+ if (workMode === "PLAN") {
106
+ return (
107
+ "\n\nPLAN MODE: You are in planning mode. " +
108
+ "Do NOT modify files, run bash, or use write/edit tools. " +
109
+ "Only read, search, and reason — investigate thoroughly, then produce a concrete implementation plan."
110
+ )
111
+ }
112
+ return ""
113
+ }
114
+
74
115
  export async function createMinicodeSession(
75
116
  opts: Partial<
76
117
  Omit<SessionConfig, "permissions" | "estimator" | "recovery" | "system" | "executor">
@@ -104,6 +145,15 @@ export async function createMinicodeSession(
104
145
  noProgress?: NoProgressOptions | false
105
146
  /** Hook opsional agar composition root dapat mereset riwayat osilasi saat verify hijau. */
106
147
  onNoProgress?: (detector: NoProgressDetector) => void
148
+ /**
149
+ * [Area B · PROMPT 06] Penyimpanan binding persetujuan milik SESI.
150
+ *
151
+ * Default: dibuat baru per sesi (lihat implementasi). Composition root
152
+ * boleh mengoper instance sendiri bila perlu membagikannya dengan lapisan
153
+ * lain; bila tidak, tiap sesi punya store sendiri sehingga bukti
154
+ * persetujuan tak pernah lintas sesi.
155
+ */
156
+ approvalBindings?: ApprovalBindingStore
107
157
  /** Menerima handle kontrol mode permission. Kernel tidak mengekspos
108
158
  * `config`, jadi satu-satunya cara mengubah mode saat runtime (mis.
109
159
  * Shift+Tab di TUI) adalah menangkap handler di sini. */
@@ -160,13 +210,15 @@ export async function createMinicodeSession(
160
210
  `createMinicodeSession: workMode ${resolvedWorkMode} dengan permissionHandler terinjeksi belum didukung (fail-closed S2.1)`,
161
211
  )
162
212
  }
163
- const planHint =
164
- opts.permissionMode === "plan"
165
- ? "\n\nPLAN MODE: You are in read-only planning mode. Do NOT modify files, run bash, or use write/edit tools. Only read, search, and reason — then output a concrete implementation plan."
166
- : ""
167
- const system = await buildSystemPrompt({
213
+ const PLAN_PM_HINT =
214
+ "\n\nPLAN MODE: You are in read-only planning mode. Do NOT modify files, run bash, or use write/edit tools. Only read, search, and reason — then output a concrete implementation plan."
215
+ // P0.2 (G-PROMPT-RT): rakit bagian dasar sekali, lalu tambahkan `planHint`
216
+ // (PermissionMode) + `workModeHint` (WorkMode) secara LIVE per-turn lewat
217
+ // pembungkus provider supaya transisi runtime `/work-mode` maupun `/mode`
218
+ // tercermin langsung di StreamRequest.system tanpa mengedit vendor/minicore.
219
+ const baseSystem = await buildSystemPrompt({
168
220
  cwd: opts.cwd,
169
- extra: (opts.systemExtra ?? "") + planHint,
221
+ extra: opts.systemExtra ?? "",
170
222
  signal: (opts as unknown as { signal?: AbortSignal }).signal,
171
223
  })
172
224
  const {
@@ -189,9 +241,16 @@ export async function createMinicodeSession(
189
241
  maxTurns,
190
242
  noProgress,
191
243
  onNoProgress,
244
+ approvalBindings: _approvalBindings,
192
245
  ...rest
193
246
  } = opts
194
247
  if (!provider) throw new Error("createMinicodeSession: provider is required")
248
+ // [Area B · PROMPT 06] Penyimpanan binding persetujuan milik SESI ini.
249
+ // Dibuat di sini (bukan global) supaya dua sesi dalam satu proses tak
250
+ // saling memakai bukti persetujuan. Root = cwd sesi (sama dengan yang
251
+ // dipakai tool untuk resolve path target).
252
+ const approvalBindings =
253
+ _approvalBindings ?? new ApprovalBindingStore(resolve(cwd ?? process.cwd()))
195
254
  // F-09: sanitasi batas di lapisan app (mencakup pemanggil library langsung,
196
255
  // bukan hanya CLI yang sudah sanitasi di cli/setup.ts + cli/index.ts).
197
256
  // Tanpa ini: timeoutMs NaN/negatif = abort instan; maxSteps 0/negatif =
@@ -227,6 +286,11 @@ export async function createMinicodeSession(
227
286
  // menggeser EXECUTE→DISCUSS/PLAN di sesi yang sama. Wrapper EXECUTE
228
287
  // mendelegasikan keputusan ke base apa adanya (perilaku identik) tetapi
229
288
  // tetap menyediakan __setWorkMode.
289
+ //
290
+ // Tool Access Policy: set tool terotorisasi = tool yang terlihat/terdaftar
291
+ // (termasuk MCP runtime dari server terkonfigurasi). Dipakai `auto` untuk
292
+ // membedakan MCP sah dari MCP tak-terkonfigurasi (fail-closed deny).
293
+ const authorizedTools = new Set((rest.tools ?? []).map((t) => t.name))
230
294
  const permissions =
231
295
  opts.permissionHandler ??
232
296
  createWorkModePermissionHandler({
@@ -237,6 +301,10 @@ export async function createMinicodeSession(
237
301
  ask,
238
302
  allowLocalConfig,
239
303
  onApprovalEvent,
304
+ authorizedTools,
305
+ // [Area B · PROMPT 06] Store per-sesi: persetujuan dari sesi A tak
306
+ // bisa dipakai sebagai bukti di sesi B.
307
+ approvalBindings,
240
308
  }),
241
309
  root: cwd,
242
310
  })
@@ -250,7 +318,7 @@ export async function createMinicodeSession(
250
318
  __getWorkMode?(): WorkMode
251
319
  }
252
320
  const registeredTools = rest.tools ?? []
253
- const allToolsPureRead =
321
+ const isAllToolsPureRead = (): boolean =>
254
322
  registeredTools.length > 0 &&
255
323
  registeredTools.every((t) => contractForTool(t.name)?.sideEffectTier === "PURE_READ")
256
324
  const livePosture = (): NoProgressPosture => {
@@ -261,7 +329,7 @@ export async function createMinicodeSession(
261
329
  const wm = wmCtl.__getWorkMode?.() ?? resolvedWorkMode
262
330
  if (wm === "DISCUSS") return "readonly"
263
331
  if (wm === "PLAN") return "plan"
264
- if (allToolsPureRead) return "explore"
332
+ if (isAllToolsPureRead()) return "explore"
265
333
  return "active"
266
334
  }
267
335
  const effectiveRoot = cwd ?? process.cwd()
@@ -278,24 +346,64 @@ export async function createMinicodeSession(
278
346
  // 1. `detector.assertBeforeCall` memblokir panggilan yang terdeteksi
279
347
  // no-progress / osilasi SEBELUM intent jurnal ditulis & sebelum efek.
280
348
  // 2. `detector.capturePreMutation` merekam hash pra-efek untuk osilasi.
281
- // 3. `beforeToolEffect` menulis intent jurnal secara awaited.
282
- const withEffectBarrier: PermissionHandler =
283
- detector === null && beforeToolEffect === undefined
284
- ? permissions
285
- : {
286
- ...permissions,
287
- check: async (call, deps) => {
288
- const decision = await permissions.check(call, deps)
289
- if (decision !== "allow") return decision
290
- if (detector !== null) {
291
- await detector.beforeToolEffectCheck(call, effectiveRoot)
292
- }
293
- if (beforeToolEffect !== undefined) {
294
- await beforeToolEffect(call)
295
- }
296
- return "allow"
297
- },
349
+ // 3. `beforeToolEffect` writes intent jurnal secara awaited.
350
+ //
351
+ // [Area B · PROMPT 06] Barrier ini juga BATAS EKSEKUSI verifikasi
352
+ // persetujuan: setelah awaital intent jurnal + no-progress di atas, yang
353
+ // tersisa ke `tool.execute` hanya kode sinkron kernel
354
+ // (`permissions.check` → `validateArgs` → emit → execute), jadi verifikasi
355
+ // di sini efektif sama dengan memeriksa tepat sebelum eksekusi. Membungkus
356
+ // tool TIDAK dipakai: itu mengganti objek di array tool LIVE yang dipegang
357
+ // kernel/`setWorkMode` (regresi `test/work-mode-runtime.test.ts`).
358
+ //
359
+ // Alasan deny "approval stale" dicatat terpisah karena handler base
360
+ // menyimpan alasannya di peta privat; kernel membacanya lewat
361
+ // `describeDenial` yang kita override.
362
+ const staleDenyReasons = new Map<string, string>()
363
+ // Barrier selalu dipasang (bukan hanya bila detector/journal ada): di sini
364
+ // verifikasi persetujuan terjadi, dan ia harus berlaku di SETIAP konfigurasi
365
+ // — termasuk sesi tanpa jurnal dan tanpa detektor.
366
+ const withEffectBarrier: PermissionHandler = {
367
+ ...permissions,
368
+ check: async (call, deps) => {
369
+ const decision = await permissions.check(call, deps)
370
+ if (decision !== "allow") return decision
371
+ // Ambil (konsumsi) bukti persetujuan milik call ini — sekali saja.
372
+ // Diambil SEBELUM await supaya tak ada binding tersisa kalau barrier
373
+ // memblokir call (tak ada deny lalu tak ada jejak).
374
+ const binding = approvalBindings.take(call.name, canonicalArgsHash(call.args))
375
+ if (detector !== null) {
376
+ await detector.beforeToolEffectCheck(call, effectiveRoot)
377
+ }
378
+ if (beforeToolEffect !== undefined) {
379
+ await beforeToolEffect(call)
380
+ }
381
+ // Verifikasi lapis-2 (batas eksekusi): fail-closed saat target berubah
382
+ // sejak user menyetujui.
383
+ const verdict = verifyApprovalBinding(binding)
384
+ if (verdict.kind === "stale") {
385
+ const id = (call as { id?: string } | null)?.id
386
+ if (id) {
387
+ if (staleDenyReasons.size > 500)
388
+ staleDenyReasons.delete(staleDenyReasons.keys().next().value as string)
389
+ staleDenyReasons.set(id, `approval stale: ${verdict.reason}`)
390
+ }
391
+ return "deny"
392
+ }
393
+ return "allow"
394
+ },
395
+ describeDenial: (call) => {
396
+ const id = (call as { id?: string } | null)?.id
397
+ if (id) {
398
+ const reason = staleDenyReasons.get(id)
399
+ if (reason) {
400
+ staleDenyReasons.delete(id)
401
+ return reason
298
402
  }
403
+ }
404
+ return permissions.describeDenial?.(call)
405
+ },
406
+ }
299
407
  // [PHASE 6U] An INJECTED handler is not a mode, and has no mode control.
300
408
  //
301
409
  // [DESIGN DECISION] `onPermissions` and `livePermissionMode` are deliberately NOT
@@ -326,17 +434,33 @@ export async function createMinicodeSession(
326
434
  // Teruskan mode live ke kernel agar ToolContext.permissionMode selalu
327
435
  // mencerminkan Shift+Tab saat itu (bukan snapshot saat sesi dibuat).
328
436
  const livePermissionMode = (): PermissionMode => (injected ? "readonly" : withMode.__getMode())
437
+ const computeLiveSystem = (): string => {
438
+ const pm = injected ? opts.permissionMode : withMode.__getMode()
439
+ const wm = injected ? resolvedWorkMode : (wmCtl.__getWorkMode?.() ?? resolvedWorkMode)
440
+ const planHint = pm === "plan" ? PLAN_PM_HINT : ""
441
+ return baseSystem + planHint + workModeHint(wm)
442
+ }
443
+ const dynamicProvider: ModelProvider = {
444
+ id: provider.id,
445
+ get models() {
446
+ return provider.models
447
+ },
448
+ stream(req, signal) {
449
+ return provider.stream({ ...req, system: computeLiveSystem() }, signal)
450
+ },
451
+ }
329
452
  // [Fase 3 / CTX-03] Estimator terkalibrasi terhadap usage aktual provider.
330
453
  const calibration = createCalibratedEstimator()
331
- const toolSchemasForEstimate = registeredTools.map((t) => ({
332
- name: t.name,
333
- description: t.description,
334
- parameters: t.parameters,
335
- }))
454
+ const liveToolSchemas = () =>
455
+ registeredTools.map((t) => ({
456
+ name: t.name,
457
+ description: t.description,
458
+ parameters: t.parameters,
459
+ }))
336
460
  const core = createCoreSession({
337
461
  ...rest,
338
- provider,
339
- system,
462
+ provider: dynamicProvider,
463
+ system: computeLiveSystem(),
340
464
  permissions: withEffectBarrier,
341
465
  permissionMode: livePermissionMode,
342
466
  estimator: calibration.estimator,
@@ -354,8 +478,8 @@ export async function createMinicodeSession(
354
478
  const d = e.data as { inputTokens?: number; totalTokens?: number } | undefined
355
479
  if (!d) return
356
480
  const baseLocal =
357
- estimateSystem(system, minicodeEstimator) +
358
- estimateTools(toolSchemasForEstimate, minicodeEstimator) +
481
+ estimateSystem(computeLiveSystem(), minicodeEstimator) +
482
+ estimateTools(liveToolSchemas(), minicodeEstimator) +
359
483
  estimateMessages(core.state.history, minicodeEstimator)
360
484
  calibration.observeProviderUsage({
361
485
  localEstimatedTokens: baseLocal,
@@ -2,40 +2,61 @@ import type { Tool } from "#minicore"
2
2
  import type { MinicodeConfig } from "../config.ts"
3
3
  import { configureServers as lspConfigure } from "../lsp/client.ts"
4
4
  import { connectAll as mcpConnectAll } from "../mcp/client.ts"
5
+ import {
6
+ EXPLORE_TOOL_NAMES,
7
+ LOCAL_READONLY_TOOL_NAMES,
8
+ PLAN_EXTRA_TOOL_NAMES,
9
+ READONLY_TOOL_NAMES,
10
+ } from "../policy/tool-contract.ts"
5
11
  import { isMcpToolName } from "../presentation/label.ts"
6
12
  import type { CanonicalScope } from "../session/verification.ts"
7
13
  import { createBashJobTools } from "../tools/bash.ts"
8
14
  import { withEvidence } from "../tools/evidence.ts"
9
15
  import { allTools, withMcpTools } from "../tools/index.ts"
10
- import { EXPLORE_TOOL_NAMES } from "../tools/task.ts"
11
16
 
12
17
  const errMsg = (e: unknown) => (e instanceof Error ? e.message : String(e))
13
18
 
14
19
  export type ToolScope = "full" | "explore"
15
20
 
16
- const PLAN_EXTRA = new Set(["todo_write", "delegate_task", "submit_result"])
21
+ const LOCAL_READONLY_SET: ReadonlySet<string> = new Set(LOCAL_READONLY_TOOL_NAMES)
17
22
 
18
- // WorkMode ceiling (P12 S2.2) — lapisan intent di ATAS permission mode.
19
- // Invariant INV-WM1: WorkMode TIDAK PERNAH memperluas akses; ia hanya
20
- // mempersempit. Karena itu filter di bawah digabung sebagai IRISAN dengan
21
- // filter permission mode: nama tool harus lolos KEDUANYA. Kombinasi
22
- // workMode=PLAN × permissionMode=readonly → irisan tetap explore (tidak
23
- // memperluas visibilitas readonly), sesuai matriks REV-2 sel PLAN×readonly.
24
- //
25
- // Murni + diekspor untuk test (pola repo: pure/diekspor-untuk-test). Tes MCP
26
- // visibility memanggilnya dengan tool bertitik tanpa men-spawn server MCP.
27
- export function workModeVisible(name: string, workMode: "DISCUSS" | "PLAN" | "EXECUTE"): boolean {
28
- if (workMode === "DISCUSS") return EXPLORE_TOOL_NAMES.includes(name)
29
- if (workMode === "PLAN") return EXPLORE_TOOL_NAMES.includes(name) || PLAN_EXTRA.has(name)
30
- // EXECUTE = tanpa ceiling tambahan (perilaku lama).
23
+ // WorkMode ceiling (P12 S2.2 + P0.2) — lapisan intent di ATAS permission mode.
24
+ // Invariant INV-WM1 & #7: WorkMode TIDAK PERNAH memperluas akses; `visible`
25
+ // diselaraskan penuh dengan `callable` di handler:
26
+ // - DISCUSS: tepat 16 tool PURE_READ lokal (`LOCAL_READONLY_TOOL_NAMES`);
27
+ // `web_fetch` & `web_search` ditolak dan disembunyikan.
28
+ // - PLAN: 18 `READONLY_TOOL_NAMES` (16 lokal + 2 network read ber-approval) +
29
+ // `PLAN_EXTRA` (kecuali bila `permissionMode` adalah `readonly`/`allowlist`
30
+ // yang ceiling-nya `readonly`).
31
+ // - EXECUTE: tanpa ceiling WorkMode tambahan; mengikuti `permissionMode`.
32
+ export function workModeVisible(
33
+ name: string,
34
+ workMode: "DISCUSS" | "PLAN" | "EXECUTE",
35
+ permissionMode?: string,
36
+ ): boolean {
37
+ if (isMcpToolName(name)) {
38
+ return workMode === "EXECUTE" && permissionMode !== "readonly" && permissionMode !== "plan"
39
+ }
40
+ if (workMode === "DISCUSS") return LOCAL_READONLY_SET.has(name)
41
+ if (workMode === "PLAN") {
42
+ if (permissionMode === "readonly" || permissionMode === "allowlist") {
43
+ return READONLY_TOOL_NAMES.has(name)
44
+ }
45
+ return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA_TOOL_NAMES.has(name)
46
+ }
47
+ // EXECUTE = tanpa ceiling WorkMode tambahan; hormati filter PermissionMode.
48
+ if (permissionMode === "readonly") return READONLY_TOOL_NAMES.has(name)
49
+ if (permissionMode === "plan")
50
+ return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA_TOOL_NAMES.has(name)
31
51
  return true
32
52
  }
33
53
 
34
54
  export function applyWorkModeFilter<T extends Tool>(
35
55
  tools: readonly T[],
36
56
  workMode: "DISCUSS" | "PLAN" | "EXECUTE",
57
+ permissionMode?: string,
37
58
  ): T[] {
38
- return tools.filter((t) => workModeVisible(t.name, workMode))
59
+ return tools.filter((t) => workModeVisible(t.name, workMode, permissionMode))
39
60
  }
40
61
 
41
62
  export type ToolEvidenceMode = "events" | "canonical"
@@ -47,31 +68,22 @@ export async function setupToolLayer(
47
68
  verification?: CanonicalScope,
48
69
  jobOwnerSid?: string,
49
70
  workMode: "DISCUSS" | "PLAN" | "EXECUTE" = "EXECUTE",
71
+ cwd?: string,
50
72
  ): Promise<{
51
73
  sessionTools: Tool[]
52
74
  evidenceMode: ToolEvidenceMode
53
75
  /** P12 S2.2 Slice 5 - set WorkMode runtime (visibilitas tool). */
54
76
  setWorkMode?: (m: "DISCUSS" | "PLAN" | "EXECUTE") => void
77
+ /** P0.2 - set PermissionMode runtime agar visibilitas tetap sinkron saat /mode atau Shift+Tab. */
78
+ setPermissionMode?: (pm: string) => void
55
79
  }> {
56
80
  let sessionTools: Tool[] = allTools
57
- // Harness-P2: scope explore = subset read-only (sama seperti sub-agen).
58
- // MCP runtime ikut terpotong (nama bertitik tak ada di daftar) — least privilege.
81
+ // Harness-P2: scope explore = subset read-only sub-agen (tetap 12 EXPLORE_TOOL_NAMES).
59
82
  if (scope === "explore")
60
83
  sessionTools = allTools.filter((t) => EXPLORE_TOOL_NAMES.includes(t.name))
61
- // Paket perbaikan (1): plan/readonly sembunyikan tool tulis dari daftar agar
62
- // model tak buang langkah mencoba yang pasti ditolak. Daftar fixed per sesi
63
- // (ikuti docs/HARNESS.md batasan sadar).
64
- if (permissionMode === "readonly") {
65
- sessionTools = sessionTools.filter((t) => EXPLORE_TOOL_NAMES.includes(t.name))
66
- } else if (permissionMode === "plan") {
67
- sessionTools = sessionTools.filter(
68
- (t) => EXPLORE_TOOL_NAMES.includes(t.name) || PLAN_EXTRA.has(t.name),
69
- )
70
- }
71
84
  // F-03 (P5 §C2): background bash job diikat ke sid kanonik sesi ini.
72
- // Rebind instance SEBELUM withEvidence agar pembungkus evidence membungkus
73
- // instance yang sudah terikat sid (bukan sebaliknya). Hanya jika nama ada di
74
- // daftar — filter explore/plan di atas tetap berlaku (least privilege).
85
+ // Rebind dilakukan pada kandidat penuh sebelum filter mode supaya transisi
86
+ // runtime DISCUSS/PLAN/readonly → EXECUTE tetap mendapat bash terikat sid.
75
87
  if (jobOwnerSid) {
76
88
  const owned = createBashJobTools(jobOwnerSid)
77
89
  const rebind = new Map<string, Tool>([
@@ -82,10 +94,10 @@ export async function setupToolLayer(
82
94
  sessionTools = sessionTools.map((t) => rebind.get(t.name) ?? t)
83
95
  }
84
96
  try {
85
- if (cfg.mcpServers?.length) {
86
- const mcpTools = await mcpConnectAll(cfg.mcpServers)
97
+ if (cfg.mcpServers?.length && scope !== "explore") {
98
+ // P2.3: bawa cwd agar pin skema tersimpan per-workspace.
99
+ const mcpTools = await mcpConnectAll(cfg.mcpServers, cwd)
87
100
  if (mcpTools.length) {
88
- // Plan/readonly: filter MCP juga, bukan balik ke allTools (bug lama).
89
101
  sessionTools = withMcpTools(sessionTools, mcpTools)
90
102
  }
91
103
  }
@@ -95,9 +107,6 @@ export async function setupToolLayer(
95
107
  try {
96
108
  if (cfg.lspServers?.length) lspConfigure(cfg.lspServers)
97
109
  } catch (e) {
98
- // Label "[lsp]" — BUKAN "[mcp]": mengarang label yang salah membuat
99
- // operator mengira MCP yang rusak, padahal yang gagal adalah registrasi
100
- // server LSP.
101
110
  process.stderr.write(`[lsp] init failed: ${errMsg(e)}\n`)
102
111
  }
103
112
  if (verification) {
@@ -105,40 +114,38 @@ export async function setupToolLayer(
105
114
  // registry invocation. Special paths keep their explicit instrumentation.
106
115
  sessionTools = sessionTools.map((tool) => withEvidence(tool, verification))
107
116
  }
108
- // P12 S2.2 Slice 5 - visibilitas tool runtime.
109
- //
110
- // Kenapa mutasi IN-PLACE: kernel menyimpan registry dari array yang sama
111
- // (`createToolRegistry(config.tools)` menyimpan referensi; `list()` mengembalikannya
112
- // apa adanya) dan `loop.ts` memetakan `registry.list()` per request. Jadi
113
- // mengganti isi array yang dipegang kernel mengubah daftar tool yang dilihat
114
- // model pada turn BERIKUTNYA tanpa perlu ganti handler/session.
115
- //
116
- // Batas jujur: `registry.get(name)` tetap memakai map yang dibuat saat
117
- // konstruksi, jadi tool yang disembunyikan masih bisa dipanggil model bila
118
- // ia menebak namanya. Yang MENOLAK tetap permission ceiling handler
119
- // (WorkMode non-EXECUTE) - visibilitas hanya lapisan UX/least-privilege,
120
- // bukan gerbang keamanan.
121
- const preWorkMode = sessionTools
122
- const mcpBlockedByPermission = permissionMode === "plan" || permissionMode === "readonly"
123
- const computeVisible = (wm: "DISCUSS" | "PLAN" | "EXECUTE"): Tool[] => {
124
- let list = preWorkMode
125
- // Tool MCP runtime ber-nama bertitik ditolak pada plan/readonly (kontrak
126
- // lama) dan pada WorkMode non-EXECUTE (ceiling tak memuat tool MCP).
127
- if (mcpBlockedByPermission || wm !== "EXECUTE") {
128
- list = list.filter((t) => !isMcpToolName(t.name) || EXPLORE_TOOL_NAMES.includes(t.name))
117
+ // P12 S2.2 + P0.2 - visibilitas tool runtime (sinkron terhadap WorkMode DAN
118
+ // PermissionMode). `parallelExecutor` meresolusi `registry.get(name)` dari
119
+ // `list()` yang sama sehingga `callable === visible` di kedua arah transisi.
120
+ const candidates = sessionTools
121
+ let currentWm: "DISCUSS" | "PLAN" | "EXECUTE" = workMode
122
+ let currentPm: string | undefined = permissionMode
123
+ const computeVisible = (wm: "DISCUSS" | "PLAN" | "EXECUTE", pm?: string): Tool[] => {
124
+ if (scope === "explore") {
125
+ // Scope explore sudah dibatasi ke EXPLORE_TOOL_NAMES; tetap terapkan irisan WorkMode.
126
+ return applyWorkModeFilter(candidates, wm, pm)
129
127
  }
130
- return applyWorkModeFilter(list, wm)
128
+ return applyWorkModeFilter(candidates, wm, pm)
131
129
  }
132
130
  // Array LIVE: identitas objek ini yang dipegang kernel.
133
- const visible: Tool[] = computeVisible(workMode)
134
- const setWorkMode = (wm: "DISCUSS" | "PLAN" | "EXECUTE"): void => {
135
- const next = computeVisible(wm)
131
+ const visible: Tool[] = computeVisible(currentWm, currentPm)
132
+ const syncVisible = (): void => {
133
+ const next = computeVisible(currentWm, currentPm)
136
134
  visible.length = 0
137
135
  visible.push(...next)
138
136
  }
137
+ const setWorkMode = (wm: "DISCUSS" | "PLAN" | "EXECUTE"): void => {
138
+ currentWm = wm
139
+ syncVisible()
140
+ }
141
+ const setPermissionMode = (pm: string): void => {
142
+ currentPm = pm
143
+ syncVisible()
144
+ }
139
145
  return {
140
146
  sessionTools: visible,
141
147
  evidenceMode: verification ? "canonical" : "events",
142
148
  setWorkMode,
149
+ setPermissionMode,
143
150
  }
144
151
  }