minicode-ai 0.13.0 → 0.14.0

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 +23 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -0
  4. package/cli/args.ts +50 -2
  5. package/cli/commands/acp.ts +18 -3
  6. package/cli/commands/daemon.ts +114 -19
  7. package/cli/commands/exec.ts +95 -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 +30 -5
  12. package/cli/minicode.js +6 -0
  13. package/cli/setup.ts +365 -24
  14. package/cli/tui.ts +72 -27
  15. package/docs/TERMINAL_CONTRACT.md +91 -24
  16. package/docs/agents.md +2 -2
  17. package/docs/cli.md +1 -0
  18. package/docs/environment.md +1 -0
  19. package/docs/memory-sessions.md +5 -0
  20. package/package.json +3 -2
  21. package/src/app/session.ts +153 -35
  22. package/src/app/tool-layer.ts +67 -61
  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 +243 -26
  40. package/src/policy/tool-contract.ts +77 -0
  41. package/src/policy/usage.ts +3 -1
  42. package/src/policy/work-mode.ts +49 -1
  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 +14 -5
  58. package/src/ui/i18n/en.ts +9 -0
  59. package/src/ui/i18n/id.ts +9 -0
  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 +7 -3
  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
@@ -1,9 +1,20 @@
1
1
  import { resolve } from "node:path"
2
2
  import { cwd } from "node:process"
3
3
  import type { PermissionHandler, ToolCall } from "#minicore"
4
- import type { ApprovalEventHook, ApprovalHookEvent } from "../presentation/events.ts"
4
+ import type {
5
+ ApprovalEventHook,
6
+ ApprovalHookEvent,
7
+ SideEffectTierDisplay,
8
+ } from "../presentation/events.ts"
5
9
  import { isMcpToolName } from "../presentation/label.ts"
6
10
  import { loadAllowlist, matchAllowlist, saveAllowlist } from "./allowlist.ts"
11
+ // [Area B · PROMPT 06] Binding persetujuan ↔ operasi yang dieksekusi.
12
+ import {
13
+ type ApprovalBinding,
14
+ type ApprovalBindingStore,
15
+ captureApprovalBinding,
16
+ verifyApprovalBinding,
17
+ } from "./approval-binding.ts"
7
18
  import { inspectBashCommand } from "./bash-guard.ts"
8
19
  import {
9
20
  isCwdOutsideRoot,
@@ -14,6 +25,9 @@ import {
14
25
  isSensitive,
15
26
  isTrashRestore,
16
27
  } from "./jail.ts"
28
+ import { scrubSecrets } from "./scrub.ts"
29
+ // [Fase 2 / TOOL-01] Diimpor dari registry kontrak tool (satu sumber).
30
+ import { contractForTool, GATED_TOOLS, READONLY_TOOL_NAMES } from "./tool-contract.ts"
17
31
 
18
32
  export type PermissionMode = "auto" | "readonly" | "plan" | "allow-all" | "ask" | "allowlist"
19
33
 
@@ -28,28 +42,33 @@ export type PermissionAsk = (call: {
28
42
  args?: unknown
29
43
  /** [Fase 2 / LOOP-INV-08] Identitas pemanggilan untuk pengikatan approval. */
30
44
  id?: string
45
+ /** F-APPROVAL-1: tier risiko efek samping (dari kontrak tool). */
46
+ riskTier?: SideEffectTierDisplay
47
+ /** F-APPROVAL-1: pratinjau diff ringkas (sudah di-scrub secret). */
48
+ diffPreview?: string
49
+ /** P1.2: `always` tersedia hanya bila args dapat dipersist (≤ 2 KB JSON). */
50
+ canAlways?: boolean
31
51
  }) => Promise<"allow" | "deny" | "always">
32
52
 
33
- const READONLY_TOOLS = new Set([
34
- "read_file",
35
- "glob",
36
- "grep",
37
- "git_status",
38
- "git_diff",
39
- "git_log",
40
- "web_fetch",
41
- "web_search",
42
- "read_memory",
43
- "todo_read",
44
- "mcp_list",
45
- "lsp_diagnostics",
46
- "lsp_definition",
47
- "lsp_references",
48
- "lsp_hover",
49
- "lsp_symbols",
50
- "lsp_workspace_symbols",
51
- "read_image",
52
- ])
53
+ /** Batas args yang boleh dipersist sebagai grant `always` (fail-closed). */
54
+ const MAX_ALWAYS_ARGS_JSON = 2000
55
+
56
+ /** P1.2: satu sumber kebenaran untuk ketersediaan opsi `always`. */
57
+ export function canPersistAlways(args: unknown): boolean {
58
+ try {
59
+ return JSON.stringify(args).length <= MAX_ALWAYS_ARGS_JSON
60
+ } catch {
61
+ return false
62
+ }
63
+ }
64
+
65
+ // [Fase 2 / TOOL-01] Satu sumber kebenaran: `READONLY_TOOLS` kini diturunkan
66
+ // dari registry kontrak tool (`allowedInReadonly`) — bukan lagi daftar manual
67
+ // yang bisa menyimpang dari `tool-contract.ts`. Menambah/mengganti tool read
68
+ // berarti mengubah `allowedInReadonly` di registry; tidak ada daftar kedua
69
+ // untuk lupa. Membership (termasuk in/out `web_fetch`/`web_search`) dipegang
70
+ // test no-drift di p15-phase2-contracts-approval-recovery.test.ts.
71
+ const READONLY_TOOLS: ReadonlySet<string> = READONLY_TOOL_NAMES
53
72
  // Tool yang menulis state internal minicode (bukan file workspace) — aman
54
73
  // di semua mode kecuali readonly/plan. `bash_kill` menghentikan proses yang
55
74
  // dimulai agent sendiri, jadi tidak menambah permukaan serangan.
@@ -84,8 +103,6 @@ const NO_PROMPT_TOOLS = new Set(["todo_write", "submit_result", "bash_output", "
84
103
  // `ask_user` di-gate: model yang bisa bertanya tanpa batas bisa membanjiri
85
104
  // user (atau memancing jawaban kredensial) — persetujuan sekali per sesi
86
105
  // via `[a] Always` tetap tersedia.
87
- // [Fase 2 / TOOL-01] Diimpor dari registry kontrak tool (satu sumber).
88
- import { GATED_TOOLS } from "./tool-contract.ts"
89
106
 
90
107
  // Denylist bash kini di src/policy/bash-guard.ts — pemeriksaan dilakukan pada
91
108
  // bentuk TERNORMALISASI (quote dibuang, variabel sederhana disubstitusi), bukan
@@ -157,6 +174,112 @@ function matchBashAllowlist(cmd: string, pattern: string): boolean {
157
174
  return re.test(trimmed)
158
175
  }
159
176
 
177
+ // F-APPROVAL-1: pratinjau diff ringkas + representatif (satu baris) untuk kartu
178
+ // approval. Dikomputasi di policy — satu-satunya lapisan yang BOLEH memakai
179
+ // scrubSecrets (view tidak boleh impor src/policy). Bentuknya dipilih per-tool
180
+ // agar menggambarkan operasi NYATA (bash → perintah, tulis/edit → path + isi
181
+ // baru, hapus/pindah → tujuan, commit → pesan), bukan "ringkasan pendek" fiktif.
182
+ // Semua teks dibasuh secret; kegagalan apa pun = undefined (preview hanyalah
183
+ // informasi tambahan, bukan jalur keputusan gate).
184
+ function buildDiffPreview(name: string, args: unknown): string | undefined {
185
+ if (args === undefined || args === null) return undefined
186
+ const a = typeof args === "object" ? (args as Record<string, unknown>) : {}
187
+ const str = (v: unknown): string => (typeof v === "string" ? v : "")
188
+ const line = (v: unknown, max = 120): string => {
189
+ const s = typeof v === "string" ? v : String(v ?? "")
190
+ const first = s.split(/\r?\n/)[0] ?? ""
191
+ return first.length > max ? `${first.slice(0, max)}…` : first
192
+ }
193
+ const text = (content: unknown): string => {
194
+ if (typeof content === "string") return content
195
+ if (Array.isArray(content))
196
+ return content
197
+ .map((c) =>
198
+ typeof c === "string"
199
+ ? c
200
+ : c && typeof c === "object" && "text" in c
201
+ ? String((c as { text?: unknown }).text ?? "")
202
+ : "",
203
+ )
204
+ .filter(Boolean)
205
+ .join("\n")
206
+ if (content && typeof content === "object" && "text" in content)
207
+ return String((content as { text?: unknown }).text ?? "")
208
+ return ""
209
+ }
210
+ // Basuh secret SEKALI di jalur keluar — path pun bisa memuat token; preview
211
+ // tak pernah boleh membocorkannya ke kartu UI.
212
+ const out = (raw: string): string | undefined => {
213
+ const s = scrubSecrets(raw.trim()).trim()
214
+ return s ? s.slice(0, 300) : undefined
215
+ }
216
+ try {
217
+ switch (name) {
218
+ case "bash": {
219
+ const cmd = (str(a.cmd) || str(a.command)).trim()
220
+ return cmd ? out(`$ ${cmd}`) : undefined
221
+ }
222
+ case "write_file": {
223
+ const p = str(a.path)
224
+ const head = line(text(a.content))
225
+ return p ? out(`→ ${p}${head ? ` · ${head}` : ""}`) : undefined
226
+ }
227
+ case "edit": {
228
+ const p = str(a.path)
229
+ // Skema NYATA tool `edit` = `oldString`/`newString` (src/tools/edit.ts:133-142).
230
+ // `old_string`/`new_string` dipakai sebagai fallback legacy — bukan
231
+ // sebagai nama utama: memakai yang salah membuat preview kosong
232
+ // (menampilkan "hanya path") untuk operasi yang sebenarnya mengganti
233
+ // blok kode tertentu.
234
+ const oldv = line(str(a.oldString ?? a.old_string), 80)
235
+ const newv = line(str(a.newString ?? a.new_string), 80)
236
+ const delta = `${oldv ? ` -${oldv}` : ""}${newv ? ` +${newv}` : ""}`
237
+ return p ? out(`→ ${p}${delta}`) : undefined
238
+ }
239
+ case "apply_patch": {
240
+ const p = str(a.path)
241
+ // Skema NYATA tool `apply_patch` = `patches: [{search, replace}]`
242
+ // (src/tools/patch.ts:18-35) — BUKAN `patch`/`diff`.
243
+ const patches = Array.isArray(a.patches)
244
+ ? (a.patches as { search?: unknown; replace?: unknown }[])
245
+ : []
246
+ if (patches.length > 0) {
247
+ const first = patches[0] ?? {}
248
+ const oldv = line(str(first.search), 80)
249
+ const newv = line(str(first.replace), 80)
250
+ const more = patches.length > 1 ? ` (+${patches.length - 1} blok)` : ""
251
+ const delta = `${oldv ? ` -${oldv}` : ""}${newv ? ` +${newv}` : ""}`
252
+ return p ? out(`→ ${p}${delta}${more}`) : undefined
253
+ }
254
+ const head = line(text(a.patch ?? a.diff))
255
+ return p ? out(`→ ${p}${head ? ` · ${head}` : ""}`) : undefined
256
+ }
257
+ case "delete_file":
258
+ return str(a.path) ? out(`- ${str(a.path)}`) : undefined
259
+ case "move_file":
260
+ return str(a.from) || str(a.to) ? out(`${str(a.from)} → ${str(a.to)}`) : undefined
261
+ case "git_commit": {
262
+ const m = line(str(a.message), 160)
263
+ return m ? out(`commit ${m}`) : undefined
264
+ }
265
+ default: {
266
+ // Generic: name + ringkasan key=value yang dibasuh — jangan JSON mentah
267
+ // (struktur/token yang tak dikenal scrub bisa bocor).
268
+ const keys = ["path", "file", "query", "pattern", "prompt", "url", "dir", "id", "name"]
269
+ const parts: string[] = []
270
+ for (const k of keys) {
271
+ const v = a[k]
272
+ if (typeof v === "string" && v) parts.push(`${k}=${line(v, 80)}`)
273
+ else if (typeof v === "number" || typeof v === "boolean") parts.push(`${k}=${v}`)
274
+ }
275
+ return parts.length ? out(`${name} ${parts.join(" ")}`) : undefined
276
+ }
277
+ }
278
+ } catch {
279
+ return undefined
280
+ }
281
+ }
282
+
160
283
  export function createPermissionHandler(
161
284
  opts: {
162
285
  mode?: PermissionMode
@@ -169,10 +292,22 @@ export function createPermissionHandler(
169
292
  * samping callback keputusan, bukan sebagai pengganti. Tanpa hook =
170
293
  * perilaku gate identik seperti dulu. Hook tak boleh melempar ke gate. */
171
294
  onApprovalEvent?: ApprovalEventHook
295
+ /**
296
+ * [Area B · PROMPT 06] Penyimpanan binding persetujuan milik SESI.
297
+ *
298
+ * Dipakai untuk dua hal: (1) menyimpan sidik jari args + file target
299
+ * SAAT preview dibuat (sebelum prompt), lalu (2) mengikatkannya ke
300
+ * keputusan "allow". Batas eksekusi (tool wrapper) memverifikasi ulang
301
+ * sidik jari file target dan menolak operasi yang basi.
302
+ *
303
+ * Tanpa store = perilaku lama persis (tanpa verifikasi tambahan).
304
+ */
305
+ approvalBindings?: ApprovalBindingStore
172
306
  } = {},
173
307
  ): PermissionHandler {
174
308
  const state = { mode: (opts.mode ?? "auto") as PermissionMode }
175
309
  const root = resolve(opts.root ?? cwd())
310
+ const approvalBindings = opts.approvalBindings
176
311
  const askUser = opts.ask
177
312
  const allowLocal = opts.allowLocalConfig === true
178
313
  let allowlistCache: string[] | null = null
@@ -249,7 +384,8 @@ export function createPermissionHandler(
249
384
  // Jawaban prompt yang dilaporkan ke observability. "headless" = jalur
250
385
  // tanpa prompt (mantan early-return noTty): pemanggil memetakan ke
251
386
  // keputusan deny-nya sendiri agar alasan deny tak berubah.
252
- type GatedAnswer = "allow" | "deny" | "always" | "aborted" | "headless"
387
+ // "stale" = user menyetujui, tapi target berubah selama prompt → fail-closed.
388
+ type GatedAnswer = "allow" | "deny" | "always" | "aborted" | "headless" | "stale"
253
389
 
254
390
  // Counter id persetujuan per handler (= per sesi): deterministik dan
255
391
  // test-friendly (tak perlu randomUUID untuk observability).
@@ -260,8 +396,8 @@ export function createPermissionHandler(
260
396
  // Arg raksasa (>2KB JSON, mis. write_file 1MB) tidak disimpan sama sekali
261
397
  // (fail-closed, minta persetujuan tiap kali) — kalau tidak allowlist.json
262
398
  // membengkak dan "always" menjadi blanket-allow untuk konten apa pun.
399
+ if (!canPersistAlways(call.args)) return Promise.resolve()
263
400
  const argsJson = JSON.stringify(call.args)
264
- if (argsJson.length > 2000) return Promise.resolve()
265
401
  const key = `${call.name}:${argsJson}`
266
402
  if (!sessionGrants.includes(key)) sessionGrants.push(key)
267
403
  allowlistCache = null
@@ -335,6 +471,9 @@ export function createPermissionHandler(
335
471
  }
336
472
  const ans = await gatedPrompt(call, signal, askUser, false)
337
473
  if (ans === "headless") return "deny"
474
+ // [Area B] "stale" = target berubah saat prompt → deny; alasan sudah
475
+ // dicatat di `deny()` (jangan timpa dengan "declined by user").
476
+ if (ans === "stale") return "deny"
338
477
  if (ans === "always") {
339
478
  await saveAlways(call)
340
479
  return "allow"
@@ -509,11 +648,21 @@ export function createPermissionHandler(
509
648
  describeDenial(call: ToolCall): string | undefined {
510
649
  return takeDenyReason(call)
511
650
  },
651
+ // Seam P0.2 (Q2): gerbang approval paksaan untuk network read (`web_fetch`,
652
+ // `web_search`) saat WorkMode PLAN aktif. Memakai jalur gated yang SAMA
653
+ // (`promptAskOr`: TTY + ask wajib, allowlist grant berlaku, headless = deny)
654
+ // sehingga observability persetujuan & alasan deny tetap kanonik.
655
+ async __promptGated(call: ToolCall, _deps?: unknown): Promise<"allow" | "deny"> {
656
+ const signal = (_deps as { signal?: AbortSignal } | null | undefined)?.signal
657
+ if (signal?.aborted) return "deny"
658
+ return promptAskOr(call, () => deny(call, "gated approval unavailable"), signal)
659
+ },
512
660
  }
513
661
  return returned as unknown as PermissionHandler & {
514
662
  __setMode(m: PermissionMode): void
515
663
  __getMode(): PermissionMode
516
664
  describeDenial(call: ToolCall): string | undefined
665
+ __promptGated(call: ToolCall, deps?: unknown): Promise<"allow" | "deny">
517
666
  }
518
667
 
519
668
  // Balapan prompt melawan abort: jawaban yang tiba SETELAH sesi dibatalkan
@@ -555,18 +704,53 @@ export function createPermissionHandler(
555
704
  const headless = signal?.aborted === true || !ask || (requireTTY && !process.stdin.isTTY)
556
705
  const approvalId = `ap_${++approvalCounter}`
557
706
  const callInfo = { id: call.id, name: call.name, args: call.args }
707
+ // F-APPROVAL-1: tier risiko efek samping dari kontrak tool — absen/kontrak
708
+ // tak dikenal = UNKNOWN (jelas, bukan tebakan). Tidak mengubah keputusan gate.
709
+ const riskTier = contractForTool(call.name)?.sideEffectTier ?? "UNKNOWN"
710
+ // F-APPROVAL-1: pratinjau diff yang REPRESENTATIF (per-tool) + sudah
711
+ // di-scrub secret — dihitung di policy karena hanya policy yang boleh
712
+ // memanggil scrubSecrets. Absen = tidak ada preview yang layak, kartu UI
713
+ // tetap menampilkan ringkasan args yang ada (fallback tak berubah).
714
+ const diffPreview = buildDiffPreview(call.name, call.args)
715
+ // [Area B · PROMPT 06] TANGKAP sidik jari operasi SEBELUM prompt. Ini
716
+ // "apa yang dilihat user": argumen + isi file target pada saat preview
717
+ // dibuat. Diambil sebelum `ask` karena `ask` bisa mengubah dunia (user
718
+ // sendiri atau proses lain bisa menulis file sementara prompt terbuka) —
719
+ // kalau sidik jari diambil SETELAH prompt, kita memverifikasi state yang
720
+ // tidak pernah dilihat user.
721
+ const capturedBinding: ApprovalBinding | null = approvalBindings
722
+ ? captureApprovalBinding(call.name, call.args, root)
723
+ : null
558
724
  emitApprovalSafe({
559
725
  kind: "requested",
560
726
  approvalId,
561
727
  call: callInfo,
562
728
  via: headless ? "system" : "prompt",
729
+ riskTier,
730
+ ...(diffPreview ? { diffPreview } : {}),
563
731
  })
564
732
  let ans: "allow" | "deny" | "always" | "aborted"
565
733
  try {
566
734
  // Headless = tanpa prompt (ask tak tersedia / [gated: bukan TTY] / sudah
567
735
  // abort): jawaban "deny" tanpa memanggil view — pemanggil memetakan ke
568
736
  // keputusan deny-nya sendiri agar alasan deny tak berubah.
569
- ans = headless || !ask ? "deny" : await raceAbort(ask(call), signal)
737
+ // F-APPROVAL-1: tier + diff diteruskan ke view agar kartu approval
738
+ // menunjukkan bukti yang SAMA dengan yang user setujui (bukan ringkasan
739
+ // terpisah yang bisa menyimpang dari operasi yang benar dieksekusi).
740
+ ans =
741
+ headless || !ask
742
+ ? "deny"
743
+ : await raceAbort(
744
+ ask({
745
+ id: call.id,
746
+ name: call.name,
747
+ args: call.args,
748
+ riskTier,
749
+ diffPreview,
750
+ canAlways: canPersistAlways(call.args),
751
+ }),
752
+ signal,
753
+ )
570
754
  } catch (e) {
571
755
  emitApprovalSafe({
572
756
  kind: "settled",
@@ -604,6 +788,29 @@ export function createPermissionHandler(
604
788
  })
605
789
  return "headless"
606
790
  }
791
+ if (ans === "always" || ans === "allow") {
792
+ // [Area B · PROMPT 06] Verifikasi lapis-1: persetujuan diberikan user
793
+ // untuk state file TERTENTU. Bila target berubah selama prompt
794
+ // terbuka, operasi yang disetujui ≠ operasi yang akan dieksekusi →
795
+ // FAIL-CLOSED: tolak, jangan jalankan.
796
+ //
797
+ // Verifikasi ini terjadi SEBELUM intent jurnal ditulis (barrier efek
798
+ // ada di lapisan app), jadi jurnal tak pernah memuat intent untuk
799
+ // operasi yang memang ditolak.
800
+ if (capturedBinding) {
801
+ const verdict = verifyApprovalBinding(capturedBinding)
802
+ if (verdict.kind === "stale") {
803
+ emitApprovalSafe({
804
+ kind: "settled",
805
+ approvalId,
806
+ call: callInfo,
807
+ outcome: { decision: "deny", by: "system", reason: "approval-stale" },
808
+ })
809
+ deny(call, `approval stale: ${verdict.reason}`)
810
+ return "stale"
811
+ }
812
+ }
813
+ }
607
814
  if (ans === "always") {
608
815
  emitApprovalSafe({
609
816
  kind: "settled",
@@ -611,6 +818,11 @@ export function createPermissionHandler(
611
818
  call: callInfo,
612
819
  outcome: { decision: "allow-always", by: "user" },
613
820
  })
821
+ // [Area B] Grant dibuat untuk call yang SEDANG berjalan: allowlist
822
+ // membuat call berikutnya lolos tanpa prompt, jadi tak ada bukti baru
823
+ // yang bisa diverifikasi — call ini masih terikat ke bukti yang user
824
+ // benar-benar setujui.
825
+ if (capturedBinding) approvalBindings?.grant(capturedBinding)
614
826
  return ans
615
827
  }
616
828
  emitApprovalSafe({
@@ -622,6 +834,8 @@ export function createPermissionHandler(
622
834
  ? { decision: "allow", by: "user" }
623
835
  : { decision: "deny", by: "user", reason: "declined" },
624
836
  })
837
+ // [Area B] Izin berlaku untuk operasi yang disetujui saja.
838
+ if (ans === "allow" && capturedBinding) approvalBindings?.grant(capturedBinding)
625
839
  return ans
626
840
  }
627
841
 
@@ -644,6 +858,9 @@ export function createPermissionHandler(
644
858
  const ans = await gatedPrompt(call, signal, askUser, true)
645
859
  if (ans === "headless") return noTty()
646
860
  if (ans === "aborted") return "deny"
861
+ // [Area B] "stale" = target berubah saat prompt → deny; alasan sudah
862
+ // dicatat di `deny()` (jangan timpa dengan "declined by user").
863
+ if (ans === "stale") return "deny"
647
864
  if (ans === "always") {
648
865
  await saveAlways(call)
649
866
  return "allow"