minicode-ai 0.14.0 → 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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,23 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.14.1] - 2026-11-05
4
+
5
+ ### Mode Architecture Migration — WorkMode / PermissionMode / Tool Access Policy
6
+
7
+ Pemisahan tiga tanggung jawab yang sebelumnya tercampur pada union `PermissionMode` enam nilai. Audit + laporan migrasi: `docs/audit/MODE_ARCHITECTURE_RECONCILIATION_AUDIT_2026-11-05.md` dan `docs/audit/MODE_ARCHITECTURE_MIGRATION_REPORT_2026-11-05.md`.
8
+
9
+ - **WorkMode** (`DISCUSS` / `PLAN` / `BUILD`): *bagaimana* agent bekerja. `BUILD` adalah nama produk untuk identitas internal `EXECUTE` (alias input + display; persistensi tetap `EXECUTE`). Ceiling kini dibaca langsung dari registry kontrak tool (`ceilingAllows`), bukan lagi dari handler `readonly`/`plan`.
10
+ - **PermissionMode** (`AUTO` / `ASK`): *apakah* butuh izin manusia. `AUTO` = otonomi penuh — capability yang authorized (termasuk `git_commit`, `delegate_task`, `mcp_*`) berjalan tanpa henti persetujuan rutin; `ask_user` ditolak deterministik. `ASK` = pengawasan manusia.
11
+ - **Tool Access Policy**: capability set (`READONLY_TOOL_NAMES`, `LOCAL_READONLY_TOOL_NAMES`, `PLAN_EXTRA_TOOL_NAMES`, bash allowlist, kelas gated) dikonsolidasi pada `src/policy/tool-contract.ts` tanpa registry kedua. `--allowlist`/`--allow-all` tetap sebagai profil akses warisan (deprecated).
12
+ - **Hard security tetap**: jail path, berkas sensitif, owned-state, bash-guard, approval-binding, dan injected `AutonomousPermissionHandler` (batas scheduler) tidak berubah.
13
+ - **TUI/footer/CLI**: `Tab` siklus WorkMode, `Shift+Tab` toggle PermissionMode; footer selalu `BUILD · AUTO`; `--plan` → `WorkMode PLAN` (dengan notice deprecation + **kini dipersist** di `work_mode`).
14
+
15
+ ### Keterbatasan
16
+
17
+ - `git_commit all:true` tetap bisa men-stage perubahan *tracked* lain di workspace dalam satu commit — presisi "perubahan milik task" dijaga oleh `paths` eksplisit + jail, bukan diff-scope tracker.
18
+ - Legacy `--allow-all`/`--allowlist` masih mengalir lewat string `permissionMode`; type `ToolAccessProfile` terpisah ditunda.
19
+ - Resume stderr masih mengeja identitas internal `EXECUTE` (footer/`/status`/help memakai `BUILD`).
20
+
3
21
  ## [0.14.0] - 2026-11-05
4
22
 
5
23
  ### WorkMode, observability, reliability & repository consolidation (P0–P2 + P2.3)
package/cli/args.ts CHANGED
@@ -106,15 +106,28 @@ export type CliWorkMode = "DISCUSS" | "PLAN" | "EXECUTE"
106
106
 
107
107
  /**
108
108
  * P12 S2.2 — Parse nilai WorkMode dari argumen operator (command `/work-mode`).
109
- * Murni + diekspor untuk test. Hanya tiga nilai yang sah; nilai lain = tak
110
- * dikenal (undefined) agar pemanggil bisa menolak tanpa mengubah state.
109
+ * Murni + diekspor untuk test. Tiga nilai sah + alias produk `BUILD` (→ EXECUTE
110
+ * internal); nilai lain = tak dikenal (undefined) agar pemanggil bisa menolak
111
+ * tanpa mengubah state.
111
112
  */
112
113
  export function parseWorkModeValue(raw: string): CliWorkMode | undefined {
113
114
  const norm = raw.trim().toUpperCase()
115
+ // Alias produk: BUILD == identitas runtime/persistence EXECUTE (satu identitas,
116
+ // dua ejaan — bukan enum kedua).
117
+ if (norm === "BUILD") return "EXECUTE"
114
118
  if (norm === "DISCUSS" || norm === "PLAN" || norm === "EXECUTE") return norm
115
119
  return undefined
116
120
  }
117
121
 
122
+ /**
123
+ * Nama produk WorkMode untuk antarmuka pengguna: identitas internal `EXECUTE`
124
+ * ditampilkan sebagai `BUILD`. Dipakai footer, /status, help, dan i18n agar
125
+ * semua permukaan konsisten, tanpa mengubah identitas runtime/persistence.
126
+ */
127
+ export function displayWorkMode(workMode: CliWorkMode): "DISCUSS" | "PLAN" | "BUILD" {
128
+ return workMode === "EXECUTE" ? "BUILD" : workMode
129
+ }
130
+
118
131
  /**
119
132
  * P12 S2.2 — Resolusi WorkMode dari flag CLI + env, murni & diekspor untuk
120
133
  * test (pola repo). Flag `--work-mode` mengalahkan env `MINICODE_WORK_MODE`;
@@ -138,7 +151,7 @@ export function resolveWorkModeFlag(getArg: (n: string) => string | undefined):
138
151
  return {
139
152
  workMode: "EXECUTE",
140
153
  explicit: true,
141
- warning: `--work-mode requires DISCUSS|PLAN|EXECUTE, ignoring "${raw}" (using EXECUTE)`,
154
+ warning: `--work-mode requires DISCUSS|PLAN|BUILD, ignoring "${raw}" (using BUILD/EXECUTE)`,
142
155
  }
143
156
  }
144
157
 
@@ -89,6 +89,15 @@ export async function handleExec(
89
89
  if (sandbox.mode === "none") delete process.env.MINICODE_SANDBOX
90
90
  else process.env.MINICODE_SANDBOX = sandbox.mode
91
91
  const allowlist = allowlistFlag || sandbox.fallbackPermission === "allowlist"
92
+ // [mode-architecture] Deprecation notice utk profil warisan (paritas jalur utama).
93
+ if (allowAll)
94
+ console.error(
95
+ `[deprecated] --allow-all is a privileged access profile (hard jail/guard still apply); treat it as an explicit override, not ordinary AUTO`,
96
+ )
97
+ if (allowlist)
98
+ console.error(
99
+ `[deprecated] --allowlist is a bash/tool access policy; persistent grants remain in ~/.minicode/allowlist.json`,
100
+ )
92
101
  // Audit #07 P0: local config repo tak dipercaya kecuali operator opt-in.
93
102
  const allowLocal = allowLocalConfig(subArgs)
94
103
  const budgetRaw = getArg("--budget")
package/cli/index.ts CHANGED
@@ -66,9 +66,9 @@ Options:
66
66
  --model <name> override model (provider::model)
67
67
  --provider <id> force provider id
68
68
  --session <id> session id (default random)
69
- --allow-all allow all tools
70
- --ask ask per tool (y/n/a)
71
- --plan read-only mode (no writes, bash, or sub-agents)
69
+ --allow-all allow all tools (privileged access profile; hard jail/guard still apply)
70
+ --ask ask per tool (y/n/a) — human-supervised execution
71
+ --plan deprecated: alias for --work-mode PLAN (read-only planning)
72
72
  --allowlist bash allowlist only (see MINICODE_BASH_ALLOWLIST)
73
73
  --max-steps <n> max tool steps (default 50)
74
74
  --context-window <n> context window tokens
@@ -80,8 +80,8 @@ Options:
80
80
  --budget <usd> session cost limit
81
81
  --budget-strict unknown cost + spend counts as over budget (fail-closed default)
82
82
  --tool-scope <s> full (default) | explore (read-only subset)
83
- --work-mode <m> DISCUSS | PLAN | EXECUTE (default). Intent layer above the
84
- permission mode: DISCUSS = read-only, PLAN = plan tools only.
83
+ --work-mode <m> DISCUSS | PLAN | BUILD (default). Operating mode: DISCUSS =
84
+ read-only investigation, PLAN = planning, BUILD = implementation.
85
85
  --tui deprecated no-op (interactive mode is always the fullscreen TUI)
86
86
  --enable-scheduler EXPERIMENTAL: opt in to the autonomous scheduler (default: off).
87
87
  Manual only - run /scheduler run. No timer; autonomous turns are
@@ -93,7 +93,7 @@ Options:
93
93
  admission runs nothing. Unknown value = off.
94
94
 
95
95
  TUI: /help /provider /model /sync /status /sessions /init /exit /mode /work-mode /undo /redo /clear /copy /history /compact /thinking /minimize
96
- Keys: Enter submit · Tab/Shift+Tab mode · Up/Down history · Mouse wheel/PgUp/PgDn scroll (Shift = half page)
96
+ Keys: Enter submit · Tab work-mode · Shift+Tab permission · Up/Down history · Mouse wheel/PgUp/PgDn scroll (Shift = half page)
97
97
  Home/End jump to transcript top/tail · Ctrl+R search · Esc abort turn (twice = quit) · Ctrl+D exit
98
98
  Subcommand flags (config/mcp/sessions/skills/exec/...): see 'minicode <cmd> --help'.
99
99
  `
@@ -244,9 +244,9 @@ if (args.includes("-h") || args.includes("--help")) {
244
244
  flag: "--timeout <ms>",
245
245
  desc: "hard deadline per run (default 900000 = 15min; 0 = Infinity)",
246
246
  },
247
- { flag: "--allow-all", desc: "allow all tools (no sandbox)" },
248
- { flag: "--ask", desc: "ask per tool" },
249
- { flag: "--plan", desc: "read-only plan mode" },
247
+ { flag: "--allow-all", desc: "allow all tools (privileged access profile)" },
248
+ { flag: "--ask", desc: "ask per tool (human-supervised)" },
249
+ { flag: "--plan", desc: "deprecated: alias for --work-mode PLAN" },
250
250
  { flag: "--allowlist", desc: "bash allowlist only" },
251
251
  { flag: "--interactive", desc: "interactive TUI" },
252
252
  { flag: "--verify", desc: "auto-verify + self-heal" },
@@ -256,8 +256,8 @@ if (args.includes("-h") || args.includes("--help")) {
256
256
  { flag: "--budget-strict", desc: "unknown cost + spend counts as over budget (default)" },
257
257
  { flag: "--tool-scope <full|explore>", desc: "tool subset (explore = read-only)" },
258
258
  {
259
- flag: "--work-mode <DISCUSS|PLAN|EXECUTE>",
260
- desc: "intent layer: DISCUSS (read-only), PLAN (plan tools only), EXECUTE (default)",
259
+ flag: "--work-mode <DISCUSS|PLAN|BUILD>",
260
+ desc: "operating mode: DISCUSS (read-only), PLAN (planning), BUILD (default)",
261
261
  },
262
262
  { flag: "--json", desc: "JSON output (help/exec)" },
263
263
  { flag: "--tui", desc: "deprecated no-op (interactive is always the fullscreen TUI)" },
@@ -277,6 +277,16 @@ const ask = hasFlag(args, "--ask")
277
277
  const interactive = hasFlag(args, "--interactive")
278
278
  const plan = hasFlag(args, "--plan") || process.env.MINICODE_PLAN === "1"
279
279
  const allowlist = hasFlag(args, "--allowlist") || process.env.MINICODE_PERMISSION === "allowlist"
280
+ // [mode-architecture] Deprecation notice utk profil warisan — jangan dihapus
281
+ // diam-diam; peta kompatibilitas di MODE_ARCHITECTURE_MIGRATION_REPORT.
282
+ if (allowAll)
283
+ process.stderr.write(
284
+ `[deprecated] --allow-all is a privileged access profile (hard jail/guard still apply); treat it as an explicit override, not ordinary AUTO\n`,
285
+ )
286
+ if (allowlist)
287
+ process.stderr.write(
288
+ `[deprecated] --allowlist is a bash/tool access policy; the persistent approval grants remain in ~/.minicode/allowlist.json (unrenamed)\n`,
289
+ )
280
290
  const verify = hasFlag(args, "--verify")
281
291
  const cwdRaw = getArg("--cwd")
282
292
  const cwd = cwdRaw ? resolvePath(cwdRaw) : undefined
package/cli/setup.ts CHANGED
@@ -978,9 +978,21 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
978
978
  }
979
979
  // P0.2 (Q5): saat `--resume` tanpa sinyal WorkMode eksplisit, pulihkan
980
980
  // WorkMode tersimpan dari metadata sesi (NULL legacy → default EXECUTE).
981
+ //
982
+ // [mode-architecture] --plan = alias warisan WorkMode PLAN (bukan permission
983
+ // mode). Dilipat di sini (satu titik untuk semua pemanggil: index/exec/acp).
981
984
  const persistedWorkMode = identity.resumed ? loadSessionWorkMode(sessionId, cwd) : undefined
985
+ const planAsWorkMode =
986
+ plan && !workModeExplicit && workMode === "EXECUTE" ? ("PLAN" as const) : workMode
987
+ if (plan && !workModeExplicit && workMode === "EXECUTE") {
988
+ process.stderr.write(
989
+ `${c.dim("[deprecated] --plan is now WorkMode PLAN; use --work-mode PLAN\n")}`,
990
+ )
991
+ }
982
992
  const effectiveWorkMode: "DISCUSS" | "PLAN" | "EXECUTE" =
983
- identity.resumed && !workModeExplicit ? (persistedWorkMode ?? "EXECUTE") : workMode
993
+ identity.resumed && !workModeExplicit && !plan
994
+ ? (persistedWorkMode ?? "EXECUTE")
995
+ : planAsWorkMode
984
996
  // P0.2 (Q4): tolak startup (fail-closed) bila `--verify` digabung dengan
985
997
  // WorkMode DISCUSS atau PLAN (baik dari flag/env maupun pulihan `--resume`).
986
998
  if (verify && effectiveWorkMode !== "EXECUTE") {
@@ -1145,15 +1157,10 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1145
1157
  return rc.signal
1146
1158
  })()
1147
1159
 
1148
- const permissionMode = allowAll
1149
- ? "allow-all"
1150
- : ask
1151
- ? "ask"
1152
- : plan
1153
- ? "plan"
1154
- : allowlist
1155
- ? "allowlist"
1156
- : "auto"
1160
+ // [mode-architecture] `--plan` legacy bukan lagi permission mode — pemetaannya
1161
+ // ke WorkMode PLAN terjadi di effectiveWorkMode (di atas). Sisa profil warisan
1162
+ // (allow-all/allowlist) tetap tersedia sebagai tool-access profile.
1163
+ const permissionMode = allowAll ? "allow-all" : ask ? "ask" : allowlist ? "allowlist" : "auto"
1157
1164
 
1158
1165
  // Home guard: sesi dibuka di home berisiko (glob rame, write berbahaya).
1159
1166
  // Standar industri: percaya-tapi-ingatkan, jangan tolak diam-diam maupun
@@ -1220,12 +1227,12 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1220
1227
  cfg,
1221
1228
  prompt,
1222
1229
  cwd,
1223
- // RAG retrieval tak boleh menulis access_count di mode tanpa-mutasi
1224
- // (PermissionMode readonly/plan maupun WorkMode DISCUSS/PLAN).
1225
- trackAccess:
1226
- (permissionMode as string) !== "readonly" &&
1227
- permissionMode !== "plan" &&
1228
- effectiveWorkMode === "EXECUTE",
1230
+ // RAG retrieval tak boleh menulis access_count di mode tanpa-mutasi.
1231
+ // [mode-architecture] PermissionMode readonly/plan tak lagi ada sebagai sumbu
1232
+ // persetujuan; ceiling tanpa-mutasi kini diekspresikan via WorkMode
1233
+ // DISCUSS/PLAN (effectiveWorkMode). Profil warisan allowlist/allow-all
1234
+ // tetap menulis (bukan read-only).
1235
+ trackAccess: effectiveWorkMode === "EXECUTE",
1229
1236
  }),
1230
1237
  )
1231
1238
 
package/cli/tui.ts CHANGED
@@ -36,7 +36,7 @@ import { c } from "../src/ui/render/theme.ts"
36
36
  import { defaultUiState, type UiSessionState } from "../src/ui/session-state.ts"
37
37
  import { TuiApp, type TuiHost } from "../src/ui/tui/app.ts"
38
38
  import { Transcript } from "../src/ui/tui/transcript.ts"
39
- import { parseWorkModeValue } from "./args.ts"
39
+ import { displayWorkMode, parseWorkModeValue } from "./args.ts"
40
40
  import {
41
41
  BUILTIN_COMMANDS,
42
42
  type CommandContext,
@@ -47,7 +47,11 @@ import {
47
47
  } from "./commands.ts"
48
48
  import type { CliSession } from "./setup.ts"
49
49
 
50
- const MODES = ["auto", "ask", "plan", "allowlist", "allow-all"] as const
50
+ // [mode-architecture] Approval axis (PermissionMode) = AUTO/ASK; operating axis
51
+ // (WorkMode) = DISCUSS/PLAN/BUILD, dikelola terpisah via /work-mode. Nilai
52
+ // internal tetap lowercase (auto/ask) dan EXECUTE (identitas BUILD).
53
+ const PERMISSION_MODES = ["auto", "ask"] as const
54
+ const WORK_MODE_CYCLE = ["DISCUSS", "PLAN", "EXECUTE"] as const
51
55
  // /expand [id]: tanpa arg = semua entry store; dengan id = satu tool.
52
56
  const DRIVER_COMMANDS = [
53
57
  "/compact",
@@ -215,11 +219,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
215
219
  skills: allLoadedSkills,
216
220
  toolsCount: sessionTools.length,
217
221
  // P1.2: dua dimensi selalu terbaca live di /status — bukan snapshot boot.
222
+ // [mode-architecture] /status memakai nilai PRODUK (BUILD/AUTO/ASK).
218
223
  get workMode() {
219
- return workModeControl?.getWorkMode() ?? "EXECUTE"
224
+ return displayWorkMode(workModeControl?.getWorkMode() ?? "EXECUTE")
220
225
  },
221
226
  get permissionMode() {
222
- return permissions?.getMode() ?? mode
227
+ return (permissions?.getMode() ?? mode).toUpperCase()
223
228
  },
224
229
  providerHint: cfg.providers[0]?.providerHint,
225
230
  setModelOverride: (m) => persistModelChoice(m, modelRef),
@@ -263,14 +268,24 @@ export async function runTui(ctx: CliSession): Promise<void> {
263
268
  return all.filter((t) => t.startsWith(line))
264
269
  }
265
270
 
266
- const cycleMode = (dir: 1 | -1): void => {
267
- const idx = (MODES as readonly string[]).indexOf(mode)
268
- // allow-all hanya via flag --allow-all (paritas REPL).
269
- let next = MODES[(idx + dir + MODES.length) % MODES.length]!
270
- if (next === "allow-all") next = MODES[(idx + dir * 2 + MODES.length * 2) % MODES.length]!
271
+ // Tab: cycle WorkMode (DISCUSS → PLAN → BUILD → DISCUSS). Hanya command ini
272
+ // (beserta /work-mode) yang menggeser operating mode — TIDAK permission mode.
273
+ const cycleWorkMode = (dir: 1 | -1): void => {
274
+ if (!workModeControl) return // policy terinjeksi = tanpa kontrol (fail-closed)
275
+ const current = workModeControl.getWorkMode() ?? "EXECUTE"
276
+ const idx = (WORK_MODE_CYCLE as readonly string[]).indexOf(current)
277
+ if (idx === -1) return
278
+ const next = WORK_MODE_CYCLE[(idx + dir + WORK_MODE_CYCLE.length) % WORK_MODE_CYCLE.length]!
279
+ workModeControl.setWorkMode(next)
280
+ }
281
+
282
+ // Shift+Tab: toggle PermissionMode (AUTO ↔ ASK). Tidak ada privilege change
283
+ // diam — hanya sumbu persetujuan.
284
+ const togglePermissionMode = (): void => {
285
+ if (!permissions) return
286
+ const next = permissions.getMode() === "ask" ? "auto" : "ask"
287
+ permissions.setMode(next)
271
288
  mode = next
272
- if (permissions) permissions.setMode(mode as (typeof MODES)[number])
273
- else mode = permissionMode ?? mode
274
289
  }
275
290
 
276
291
  async function runBuiltin(
@@ -444,33 +459,35 @@ export async function runTui(ctx: CliSession): Promise<void> {
444
459
  app.clearView()
445
460
  return
446
461
  }
462
+ // [mode-architecture] /mode = PermissionMode (persetujuan AUTO/ASK) SAJA.
447
463
  if (name === "mode") {
448
464
  if (args) {
449
- if (!(MODES as readonly string[]).includes(args)) {
450
- transcript.pushInfo([c.muted(t("tui.unknownMode", { a: args, modes: MODES.join(", ") }))])
465
+ const norm = args.toLowerCase()
466
+ if (!(PERMISSION_MODES as readonly string[]).includes(norm)) {
467
+ transcript.pushInfo([c.muted(t("tui.unknownMode", { a: args, modes: "AUTO, ASK" }))])
451
468
  return
452
469
  }
453
- mode = args
454
- permissions?.setMode(args as (typeof MODES)[number])
470
+ mode = norm
471
+ permissions?.setMode(norm as (typeof PERMISSION_MODES)[number])
455
472
  } else {
456
- cycleMode(1)
473
+ togglePermissionMode()
457
474
  }
458
- transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode }))])
475
+ transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode.toUpperCase() }))])
459
476
  return
460
477
  }
461
- // P12 S2.2 Slice 5 - WorkMode (lapis intent di ATAS permission mode).
462
- // Aksi operator EKSPLISIT: hanya command ini yang menggeser WorkMode.
463
- // Tab/Shift+Tab dan `/mode` tetap khusus permission mode.
478
+ // [mode-architecture] /work-mode = WorkMode (operating mode) SAJA.
479
+ // Aksi operator EKSPLISIT untuk operating mode; Tab/Shift+Tab = pintasan.
464
480
  if (name === "work-mode") {
465
481
  const current = workModeControl?.getWorkMode() ?? "EXECUTE"
482
+ const currentDisplay = displayWorkMode(current)
466
483
  if (!args) {
467
- transcript.pushInfo([c.muted(t("tui.workModeUsage", { m: current }))])
484
+ transcript.pushInfo([c.muted(t("tui.workModeUsage", { m: currentDisplay }))])
468
485
  return
469
486
  }
470
487
  const next = parseWorkModeValue(args)
471
488
  if (!next) {
472
489
  transcript.pushInfo([
473
- c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN, EXECUTE" })),
490
+ c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN, BUILD" })),
474
491
  ])
475
492
  return
476
493
  }
@@ -481,7 +498,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
481
498
  return
482
499
  }
483
500
  workModeControl.setWorkMode(next)
484
- transcript.pushInfo([c.muted(t("tui.workModeLine", { m: next }))])
501
+ transcript.pushInfo([c.muted(t("tui.workModeLine", { m: displayWorkMode(next) }))])
485
502
  return
486
503
  }
487
504
  if (name === "lang") {
@@ -656,8 +673,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
656
673
  abort: () => {
657
674
  abort?.abort()
658
675
  },
659
- cycleMode: (dir) => {
660
- cycleMode(dir)
676
+ cycleWorkMode: (dir) => {
677
+ cycleWorkMode(dir)
678
+ },
679
+ togglePermissionMode: () => {
680
+ togglePermissionMode()
661
681
  },
662
682
  toggleCompact: () => {
663
683
  const compact = ui.setCompactMode()
package/docs/agents.md CHANGED
@@ -5,14 +5,14 @@
5
5
 
6
6
  Sub-agent = instans agent dengan **context terpisah** dari parent: memory, signal, dan budget sendiri. Pool concurrency 3 — maksimum 3 sub-agent hidup sekaligus — dan abort-aware (mewarisi AbortSignal parent; parent batal → anak berhenti).
7
7
 
8
- Approval: `delegate_task` di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
8
+ Approval: `delegate_task` di-**ASK** di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. Di **AUTO**, delegasi berjalan otonom bila authorized (anak tetap ter-ceiling WorkMode parent, dipaksa explore read-only bila parent non-BUILD). **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
9
9
 
10
10
  ## Mode anak: `explore` / `plan`
11
11
 
12
12
  | Mode anak | Kemampuan |
13
13
  |---|---|
14
14
  | `explore` | Subset read-only (12 tool) — cari/pahami kode, kembalikan temuan |
15
- | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode/PM ketat** (`PLAN`/`DISCUSS`/`readonly`/`plan`/`ask`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `EXECUTE`×auto/allow-all**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
15
+ | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode ketat** (`PLAN`/`DISCUSS`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `BUILD`×AUTO**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
16
16
 
17
17
  Restriksi anak yang **selalu** berlaku: anak **tidak** bisa bersarang (`delegate_task` dibuang), tidak bisa `git_commit`, tidak menulis memory/todo, tidak memakai `bash_output`/`bash_kill` (job milik parent). Tool MCP runtime (`server.tool`) hanya muncul pada anak `plan` di bawah parent `EXECUTE`; pada `explore` maupun parent non-`EXECUTE`, daftar anak dibatasi ke `EXPLORE_TOOL_NAMES`. Plan-parent dipaksa explore saat mendelegasi.
18
18
 
@@ -1,34 +1,41 @@
1
1
  # Memilih Mode
2
2
 
3
- Satu pertanyaan, satu jawaban: **mode mana untuk tujuan saya?**
3
+ Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
4
+
5
+ 1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/plánning), `BUILD` (implementasi).
6
+ 2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
7
+ 3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
8
+
9
+ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya.
4
10
 
5
11
  ## Kalau tujuan Anda X → gunakan Y
6
12
 
7
13
  | Saya ingin… | Gunakan | Karena |
8
14
  |---|---|---|
9
- |Memahami repo tanpa mengubah apa pun | `readonly` (atau `--tool-scope explore`) | Gerbang izin mengizinkan 18 tool baca (`READONLY_TOOLS`); model tetap hanya **melihat 12** tool baca (visibilitas `EXPLORE_TOOL_NAMES`) — tulis/bash/commit/delegasi ditolak di gerbang |
10
- | Minta agen membuat perubahan | `auto` (default) | Tulis terjail + bash aman langsung jalan; yang berisiko (commit, MCP, delegasi) tetap minta izin sekali |
11
- | Menyetujui setiap perubahan | `ask` | Tiap tool non-sepele menunggu jawaban; `todo`/`bash_output` tak ditanya (bookkeeping sendiri) |
12
- | Menyusun rencana tanpa eksekusi | `plan` | Baca + tulis rencana (`todo_write`) + delegasi yang dipaksa read-only; tanpa mutasi file/git/memori |
13
- | Otomasi/CI tanpa manusia | One-shot/`exec` + mode default | `ask_user`/gated otomatis ditolak di non-TTY (fail-closed, bukan gantung); hindari prompt yang butuh klarifikasi |
14
- | Otonom penuh di mesin sendiri | `allow-all` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
15
+ | Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal (16 tool baca); network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
16
+ | Minta agen membuat perubahan | `BUILD` + `AUTO` (default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
17
+ | Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
18
+ | Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
19
+ | Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
20
+ | Otonom penuh di mesin sendiri | `BUILD`+`AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
15
21
 
16
22
  ## Rule of thumb
17
23
 
18
- 1. **Default `auto` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
19
- 2. **`readonly` untuk baca, `plan` untuk berpikir.** Bedanya: `plan` boleh menulis rencana dan mendelegasikan penelahan; keduanya tak menyentuh file/git/memori Anda.
20
- 3. **`ask` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
21
- 4. **CI = non-interaktif = tanpa approval.** Jangan desain pipeline yang bergantung pada `ask_user` atau commit oleh agent; commit tetap keputusan manusia/Workflow.
22
- 5. **`allow-all` mematikan prompt, bukan batas.** Path jail dan pola bash berbahaya tetap menolak. Pasangkan dengan sandbox + budget bila otonom.
24
+ 1. **Default `BUILD`+`AUTO` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
25
+ 2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
26
+ 3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
27
+ 4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
28
+ 5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
23
29
 
24
30
  ## Tradeoff yang jujur
25
31
 
26
32
  - Semakin otonom → semakin cepat, semakin besar blast radius bila model salah paham. Tidak ada mode yang membuat model lebih bijak — mode hanya mengatur **apa yang boleh terjadi**.
27
33
  - `allowlist` (otomatis saat tanpa sandbox OS) paling ketat untuk shell, tetapi model tetap bisa menulis file via tool terjail — pahami beda sumbunya: allowlist membatasi *perintah*, jail membatasi *file*.
28
- - Ganti mode kapan pun: flag saat start, `/mode` atau Shift+Tab saat TUI berjalan.
34
+ - Ganti mode kapan pun: flag saat start, `Tab`/`Shift+Tab` atau `/mode`+`/work-mode` saat TUI berjalan.
29
35
 
30
36
  ## Lanjut
31
37
 
32
38
  - [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
33
39
  - [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
34
40
  - [Otomasi & CI](exec.md) — batasan headless.
41
+ - [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
package/docs/cli.md CHANGED
@@ -43,10 +43,10 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
43
43
  | `--budget <usd>` | Batas biaya sesi; warn 80%, exit/break bila lewat; cost tak dikenal + pemakaian = over (fail-closed default) |
44
44
  | `--budget-strict` | Penegasan eksplisit fail-closed di atas (back-compat) |
45
45
  | `--tool-scope <s>` | `full` (default) \| `explore` = subset read-only 12 tool |
46
- | `--plan` | Read-only plan mode |
47
- | `--allowlist` | Bash hanya perintah aman |
48
- | `--ask` | Tanya persetujuan setiap tool |
49
- | `--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) |
50
50
  | `--model <name>` | Override model (`providerId::model` paksa provider) |
51
51
  | `--provider <id>` | Paksa provider id agnostik |
52
52
  | `--resume <id>` | Lanjutkan sesi (full history, bukan dump teks) |
@@ -56,21 +56,21 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
56
56
  | `--max-steps <n>` | Batas langkah tool (default 50) |
57
57
  | `--context-window <n>` | Ukuran jendela konteks (token) |
58
58
  | `--session <id>` | ID sesi (default random, disanitasi) |
59
- | `--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` |
60
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` |
61
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` |
62
62
 
63
- 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`).
64
64
 
65
65
  ## Kapan memakai apa
66
66
 
67
67
  | Tujuan | Pakai |
68
68
  |---|---|
69
- | Kerja harian biasa | Default (`auto`) — tulis aman langsung jalan, yang berisiko minta izin |
70
- | Repo asing / perintah belum dipahami | `--ask`, jawab `always` hanya untuk pasangan tool+args yang sudah dinilai |
71
- | Review tanpa eksekusi | `--plan` (+ `--tool-scope explore` bila ingin subset baca 12 tool) |
72
- | CI tanpa manusia | `exec --json` + `--budget`/`--max-steps`; hindari prompt yang butuh klarifikasi |
73
- | 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` |
74
74
  | Model mahal tak terkendali | `--budget 0.50` + `--budget-strict` + `pricing sync` |
75
75
 
76
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 `~` |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.14.0",
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,
@@ -286,6 +286,11 @@ export async function createMinicodeSession(
286
286
  // menggeser EXECUTE→DISCUSS/PLAN di sesi yang sama. Wrapper EXECUTE
287
287
  // mendelegasikan keputusan ke base apa adanya (perilaku identik) tetapi
288
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))
289
294
  const permissions =
290
295
  opts.permissionHandler ??
291
296
  createWorkModePermissionHandler({
@@ -296,6 +301,7 @@ export async function createMinicodeSession(
296
301
  ask,
297
302
  allowLocalConfig,
298
303
  onApprovalEvent,
304
+ authorizedTools,
299
305
  // [Area B · PROMPT 06] Store per-sesi: persetujuan dari sesi A tak
300
306
  // bisa dipakai sebagai bukti di sesi B.
301
307
  approvalBindings,
@@ -5,6 +5,7 @@ import { connectAll as mcpConnectAll } from "../mcp/client.ts"
5
5
  import {
6
6
  EXPLORE_TOOL_NAMES,
7
7
  LOCAL_READONLY_TOOL_NAMES,
8
+ PLAN_EXTRA_TOOL_NAMES,
8
9
  READONLY_TOOL_NAMES,
9
10
  } from "../policy/tool-contract.ts"
10
11
  import { isMcpToolName } from "../presentation/label.ts"
@@ -17,7 +18,6 @@ const errMsg = (e: unknown) => (e instanceof Error ? e.message : String(e))
17
18
 
18
19
  export type ToolScope = "full" | "explore"
19
20
 
20
- const PLAN_EXTRA = new Set(["todo_write", "delegate_task", "submit_result"])
21
21
  const LOCAL_READONLY_SET: ReadonlySet<string> = new Set(LOCAL_READONLY_TOOL_NAMES)
22
22
 
23
23
  // WorkMode ceiling (P12 S2.2 + P0.2) — lapisan intent di ATAS permission mode.
@@ -42,11 +42,12 @@ export function workModeVisible(
42
42
  if (permissionMode === "readonly" || permissionMode === "allowlist") {
43
43
  return READONLY_TOOL_NAMES.has(name)
44
44
  }
45
- return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA.has(name)
45
+ return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA_TOOL_NAMES.has(name)
46
46
  }
47
47
  // EXECUTE = tanpa ceiling WorkMode tambahan; hormati filter PermissionMode.
48
48
  if (permissionMode === "readonly") return READONLY_TOOL_NAMES.has(name)
49
- if (permissionMode === "plan") return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA.has(name)
49
+ if (permissionMode === "plan")
50
+ return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA_TOOL_NAMES.has(name)
50
51
  return true
51
52
  }
52
53
 
@@ -27,9 +27,40 @@ import {
27
27
  } from "./jail.ts"
28
28
  import { scrubSecrets } from "./scrub.ts"
29
29
  // [Fase 2 / TOOL-01] Diimpor dari registry kontrak tool (satu sumber).
30
- import { contractForTool, GATED_TOOLS, READONLY_TOOL_NAMES } from "./tool-contract.ts"
30
+ import {
31
+ contractForTool,
32
+ GATED_TOOLS,
33
+ PLAN_EXTRA_TOOL_NAMES,
34
+ READONLY_TOOL_NAMES,
35
+ } from "./tool-contract.ts"
31
36
 
32
- export type PermissionMode = "auto" | "readonly" | "plan" | "allow-all" | "ask" | "allowlist"
37
+ /**
38
+ * Approval policy — DUA nilai yang berhadapan dengan pengguna.
39
+ *
40
+ * `auto` (AUTO) = eksekusi otonom penuh: selama capability & scope diizinkan,
41
+ * aksi berjalan TANPA henti persetujuan rutin. Bukan "izinkan semuanya" —
42
+ * hard-deny (jail/owned-state/bash-guard) tetap berlaku di atasnya.
43
+ * `ask` (ASK) = pengawasan manusia: aksi yang dicakup kebijakan persetujuan
44
+ * meminta izin sebelum jalan. Hard-deny tetap tak bisa di-override.
45
+ *
46
+ * Ejaan lowercase dipertahankan sebagai identitas internal/kompatibilitas
47
+ * untuk AUTO/ASK (persistence & ToolContext memakai nilai ini).
48
+ */
49
+ export type ApprovalMode = "auto" | "ask"
50
+
51
+ /**
52
+ * Union kompatibilitas selama migrasi arsitektur mode.
53
+ *
54
+ * HANYA `"auto"`/`"ask"` adalah kebijakan persetujuan. Sisanya adalah profil
55
+ * capability WARISAN yang kini menjadi tanggung jawab Tool Access Policy:
56
+ * - `"readonly"` → capability read-only internal (bukan permukaan; batas
57
+ * scheduler adalah injected AutonomousPermissionHandler,
58
+ * BUKAN nilai ini).
59
+ * - `"plan"` → ceiling WorkMode PLAN (perencanaan user-facing = PLAN).
60
+ * - `"allowlist"` → kebijakan akses bash/tool (flag warisan --allowlist).
61
+ * - `"allow-all"` → profil akses privileged (flag warisan --allow-all).
62
+ */
63
+ export type PermissionMode = ApprovalMode | "readonly" | "plan" | "allow-all" | "allowlist"
33
64
 
34
65
  /**
35
66
  * View persetujuan yang di-inject dari composition root (cli/setup.ts memakai
@@ -303,6 +334,14 @@ export function createPermissionHandler(
303
334
  * Tanpa store = perilaku lama persis (tanpa verifikasi tambahan).
304
335
  */
305
336
  approvalBindings?: ApprovalBindingStore
337
+ /**
338
+ * Tool Access Policy — set nama tool yang DIOTORISASI sesi ini (tool yang
339
+ * terlihat/terdaftar, termasuk MCP runtime `server.tool` yang servernya
340
+ * terkonfigurasi). Dipakai `auto` untuk membedakan MCP terotorisasi dari
341
+ * MCP tak-dikenal/tak-terkonfigurasi: hanya nama bertitik yang ADA di set
342
+ * ini yang boleh auto-allow. Absen = fail-closed (semua MCP bertitik deny).
343
+ */
344
+ authorizedTools?: ReadonlySet<string> | null
306
345
  } = {},
307
346
  ): PermissionHandler {
308
347
  const state = { mode: (opts.mode ?? "auto") as PermissionMode }
@@ -310,6 +349,7 @@ export function createPermissionHandler(
310
349
  const approvalBindings = opts.approvalBindings
311
350
  const askUser = opts.ask
312
351
  const allowLocal = opts.allowLocalConfig === true
352
+ const authorizedTools = opts.authorizedTools
313
353
  let allowlistCache: string[] | null = null
314
354
  // Persetujuan "always" sesi ini — in-memory, bukan dari disk. Tanpa ini,
315
355
  // jawaban always yang baru disimpan ke berkas lokal tak terlihat saat local
@@ -418,17 +458,13 @@ export function createPermissionHandler(
418
458
  "allow-all": async () => "allow",
419
459
  readonly: async (call) =>
420
460
  READONLY_TOOLS.has(call.name) ? "allow" : deny(call, "read-only mode"),
421
- // Plan = readonly + tiga perkecualian aman: todo_write (artefak rencana
422
- // .minicode/plans, bukan file workspace), delegate_task (penelahan
423
- // rencana, bukan eksekusi — dipaksa explore/read-only di task.ts bila
424
- // parent plan/readonly, permission hanya membuka gerbangnya), dan
425
- // submit_result (singleton memori-proses untuk exec --json, tanpa tulis
426
- // file/state sesi; terlihat di PLAN_EXTRA tool-layer jadi harus boleh).
461
+ // Plan = readonly + tiga perkecualian aman (PLAN_EXTRA_TOOL_NAMES):
462
+ // todo_write (artefak rencana .minicode/plans, bukan file workspace),
463
+ // delegate_task (penelahan rencana, bukan eksekusi — dipaksa explore/
464
+ // read-only di task.ts bila parent plan/readonly, permission hanya membuka
465
+ // gerbangnya), dan submit_result (singleton memori-proses untuk exec --json).
427
466
  plan: async (call) =>
428
- READONLY_TOOLS.has(call.name) ||
429
- call.name === "todo_write" ||
430
- call.name === "delegate_task" ||
431
- call.name === "submit_result"
467
+ READONLY_TOOLS.has(call.name) || PLAN_EXTRA_TOOL_NAMES.has(call.name)
432
468
  ? "allow"
433
469
  : deny(call, "plan mode"),
434
470
  allowlist: async (call, args) => {
@@ -480,10 +516,33 @@ export function createPermissionHandler(
480
516
  }
481
517
  return ans === "allow" ? "allow" : "deny"
482
518
  },
483
- auto: async (call, args, signal) => {
519
+ // AUTO = otonomi penuh. Selama tool diotorisasi oleh Tool Access Policy dan
520
+ // scope mengizinkan, jalankan TANPA prompt persetujuan rutin. Ini berbeda
521
+ // dari `ask` (di bawah) yang menahan tulis/eksekusi untuk izin manusia.
522
+ //
523
+ // Keputusan desain (mode-architecture recon): `gatedByDefault` TIDAK lagi
524
+ // berarti "auto wajib prompt". Tool gated (git_commit, delegate_task,
525
+ // mcp_call/read/prompt) adalah capability yang WAJIB Otorisasi — di ASK
526
+ // mereka butuh izin manusia, tetapi di AUTO mereka jalan bila authorized.
527
+ // Hard-deny (jail/owned-state/bash-guard) tetap berlaku di semua jalur.
528
+ auto: async (call, args, _signal) => {
484
529
  if (READONLY_TOOLS.has(call.name)) return "allow"
485
- if (isGated(call.name))
486
- return await promptAskOr(call, () => deny(call, "gated approval unavailable"), signal)
530
+ // ask_user = interaksi-user, bukan eksekusi. Di AUTO dilarang deterministik
531
+ // (BLOCKED) supaya model memakai asumsi default sendiri — jangan biarkan
532
+ // pergantian tanya-jawab rutin mengubah AUTO jadi ASK.
533
+ if (call.name === "ask_user")
534
+ return deny(call, "ask_user unavailable in AUTO (autonomous mode)")
535
+ // Tool MCP bertitik: hanya diotorisasi bila terdaftar di sesi (server
536
+ // terkonfigurasi). Tak dikenal/tak terkonfigurasi = deny, bukan prompt
537
+ // (AUTO tak boleh bertanya sebagai jalan pintas hard-restriction).
538
+ if (isMcpToolName(call.name)) {
539
+ if (authorizedTools?.has(call.name)) return "allow"
540
+ return deny(call, "MCP tool not configured/authorized")
541
+ }
542
+ // Capability gated (git_commit, delegate_task, mcp_call/read/prompt):
543
+ // otonom di AUTO bila authorized. Scope dijaga tool-nya sendiri + jail
544
+ // (git_commit: path/staged dijail; delegate: anak ter-ceiling WorkMode).
545
+ if (GATED_TOOLS.has(call.name)) return "allow"
487
546
  if (FILE_WRITE_TOOLS.has(call.name)) return "allow"
488
547
  if (INTERNAL_WRITE_TOOLS.has(call.name)) return "allow"
489
548
  if (call.name === "code_run") {
@@ -498,7 +557,7 @@ export function createPermissionHandler(
498
557
  if (br) return deny(call, `bash-guard: ${br}`)
499
558
  return "allow"
500
559
  }
501
- return "deny"
560
+ return deny(call, "not authorized in AUTO mode")
502
561
  },
503
562
  }
504
563
 
@@ -575,6 +575,23 @@ export const NETWORK_READ_TOOL_NAMES: ReadonlySet<string> = new Set(
575
575
  ),
576
576
  )
577
577
 
578
+ /**
579
+ * Derivasi Tool Access Policy: tool ekstra yang diizinkan pada ceiling PLAN
580
+ * (di atas 18 `READONLY_TOOL_NAMES`). Tiga artefak perencanaan yang aman:
581
+ * - `todo_write` → artefak rencana `.minicode/plans` (bukan file workspace)
582
+ * - `delegate_task` → penelahan rencana (dipaksa explore/read-only di task.ts
583
+ * bila parent PLAN — permission hanya membuka gerbangnya)
584
+ * - `submit_result` → singleton memori-proses (exec --json) tanpa tulis file
585
+ *
586
+ * Satu sumber untuk ceiling WorkMode PLAN (`work-mode.ts`), visibilitas tool
587
+ * (`tool-layer.ts`), dan handler PermissionMode `plan` warisan (`permission.ts`).
588
+ */
589
+ export const PLAN_EXTRA_TOOL_NAMES: ReadonlySet<string> = new Set([
590
+ "todo_write",
591
+ "delegate_task",
592
+ "submit_result",
593
+ ])
594
+
578
595
  /**
579
596
  * Derivasi klasifikasi jurnal. Tool tak dikenal = "unknown", dan pemanggil
580
597
  * (`isMutationTool`) memperlakukannya sebagai mutasi (fail-closed).
@@ -11,8 +11,13 @@
11
11
  // menduplikasi READONLY_TOOLS atau membangun engine kedua.
12
12
 
13
13
  import type { PermissionHandler, ToolCall } from "#minicore"
14
- import { createPermissionHandler, type PermissionMode } from "./permission.ts"
15
- import { NETWORK_READ_TOOL_NAMES } from "./tool-contract.ts"
14
+ import type { PermissionMode } from "./permission.ts"
15
+ import {
16
+ LOCAL_READONLY_TOOL_NAMES,
17
+ NETWORK_READ_TOOL_NAMES,
18
+ PLAN_EXTRA_TOOL_NAMES,
19
+ READONLY_TOOL_NAMES,
20
+ } from "./tool-contract.ts"
16
21
 
17
22
  export type WorkMode = "DISCUSS" | "PLAN" | "EXECUTE"
18
23
 
@@ -76,6 +81,24 @@ function ceilingFor(workMode: RestrictiveWorkMode, baseMode: PermissionMode): "r
76
81
  return baseMode === "allowlist" || baseMode === "readonly" ? "readonly" : "plan"
77
82
  }
78
83
 
84
+ // Tool Access Policy — ceiling capability WorkMode dihitung LANGSUNG dari
85
+ // registry kontrak tool (satu sumber), bukan lewat handler PermissionMode
86
+ // `readonly`/`plan` (yang dulunya diduplikasi sebagai primitif ceiling).
87
+ //
88
+ // - DISCUSS → tepat 16 `LOCAL_READONLY_TOOL_NAMES` (network read ditolak
89
+ // terpisah di check() dengan alasan khusus).
90
+ // - PLAN → 18 `READONLY_TOOL_NAMES` (+ `PLAN_EXTRA_TOOL_NAMES`), atau
91
+ // read-only saja bila PM sudah `readonly`/`allowlist` (lebih ketat).
92
+ function ceilingAllows(
93
+ name: string,
94
+ workMode: RestrictiveWorkMode,
95
+ baseMode: PermissionMode,
96
+ ): boolean {
97
+ if (workMode === "DISCUSS") return LOCAL_READONLY_TOOL_NAMES.includes(name)
98
+ if (baseMode === "readonly" || baseMode === "allowlist") return READONLY_TOOL_NAMES.has(name)
99
+ return READONLY_TOOL_NAMES.has(name) || PLAN_EXTRA_TOOL_NAMES.has(name)
100
+ }
101
+
79
102
  export function createWorkModePermissionHandler(opts: {
80
103
  workMode: WorkMode
81
104
  base: PermissionHandler
@@ -86,15 +109,26 @@ export function createWorkModePermissionHandler(opts: {
86
109
  // mengkonsultasi handler per tool call, jadi __setWorkMode runtime menggeser
87
110
  // ceiling tanpa mengganti handler. EXECUTE = delegasi base (perilaku identik).
88
111
  let wm: WorkMode = opts.workMode
89
- const ceilings = {
90
- readonly: createPermissionHandler({
91
- mode: "readonly",
92
- root: opts.root,
93
- }) as unknown as PermissionHandler,
94
- plan: createPermissionHandler({
95
- mode: "plan",
96
- root: opts.root,
97
- }) as unknown as PermissionHandler,
112
+ // Handler deny ceiling — hanya untuk seam describeDenial (alasan yang sama
113
+ // dengan perilaku lama: "read-only mode" / "plan mode"). Tidak ada lagi
114
+ // handler PermissionMode `readonly`/`plan` sebagai primitif ceiling.
115
+ const ceilingDenyHandlers: Record<"readonly" | "plan", PermissionHandler> = {
116
+ readonly: {
117
+ async check() {
118
+ return "deny"
119
+ },
120
+ describeDenial() {
121
+ return "read-only mode"
122
+ },
123
+ },
124
+ plan: {
125
+ async check() {
126
+ return "deny"
127
+ },
128
+ describeDenial() {
129
+ return "plan mode"
130
+ },
131
+ },
98
132
  }
99
133
  const discussNetworkDeny: PermissionHandler = {
100
134
  async check() {
@@ -157,12 +191,12 @@ export function createWorkModePermissionHandler(opts: {
157
191
  // (PLAN × allowlist/readonly = read-only), bukan membekukan yang lama.
158
192
  // Baca WorkMode sekarang (`wm` mutable) — __setWorkMode runtime menggeser
159
193
  // ceiling DISCUSS↔PLAN.
160
- const ceiling = ceilings[ceilingFor(wm, ctrl.__getMode())]
161
- // Ceiling DULU: operasi di luar ceiling tak boleh memicu prompt base
162
- // (requirement S2.1 #1) — ceiling readonly/plan tak pernah prompt.
163
- const ceilingDecision = await ceiling.check(call, _deps as never)
164
- if (ceilingDecision !== "allow") {
165
- rememberDeny(call, ceiling)
194
+ const baseMode = ctrl.__getMode()
195
+ const ceilingKind = ceilingFor(wm, baseMode)
196
+ // Ceiling DULU (Tool Access Policy): operasi di luar ceiling tak boleh
197
+ // memicu prompt base (requirement S2.1 #1) — ceiling tak pernah prompt.
198
+ if (!ceilingAllows(call.name, wm, baseMode)) {
199
+ rememberDeny(call, ceilingDenyHandlers[ceilingKind])
166
200
  return "deny"
167
201
  }
168
202
  // Di dalam ceiling: keputusan mutlak handler PM asli (termasuk prompt
package/src/ui/footer.ts CHANGED
@@ -48,8 +48,8 @@ export interface FooterStatus {
48
48
  timerHighlight?: TimerHighlight
49
49
  }
50
50
 
51
- /** Lebar tetap kolom mode — `allowlist`/`allow-all` (9) adalah yang terpanjang. */
52
- const MODE_WIDTH = 9
51
+ /** Lebar tetap kolom mode — muat label terpanjang "DISCUSS · AUTO". */
52
+ const MODE_WIDTH = 14
53
53
 
54
54
  /** Buang prefix provider (`acme::deepseek-v4` → `deepseek-v4`). */
55
55
  export function shortModel(id: string): string {
@@ -57,25 +57,30 @@ export function shortModel(id: string): string {
57
57
  return i >= 0 ? id.slice(i + 2) : id
58
58
  }
59
59
 
60
+ /** Label permission (AUTO/ASK) — legacy profile warisan di-uppercase saja. */
61
+ function permissionLabel(mode: string): string {
62
+ return (mode || "").toUpperCase()
63
+ }
64
+
60
65
  /**
61
66
  * Warna + PAD token mode. Padding dilakukan sebelum pewarnaan supaya lebar
62
67
  * kolom mode tetap sama untuk semua mode (anti-geser), sementara warna tetap
63
68
  * dipilih dari nama mode asli.
64
69
  *
65
- * P12 S2.2 Slice 5 - WorkMode non-EXECUTE digabung ke label (`PLAN·auto`):
66
- * dua lapis intent/permission dibedakan dalam satu token. Warna mengikuti
67
- * lapis yang lebih ketat (WorkMode DISCUSS/PLAN -> warning seperti plan PM).
70
+ * [mode-architecture] Selalu tampilkan KEDUA lapis sebagai `<WorkMode> ·
71
+ * <PermissionMode>` (mis. `BUILD · AUTO`, `PLAN · ASK`). Identitas internal
72
+ * `EXECUTE` ditampilkan sebagai produk `BUILD`. EXECUTE/default tak lagi
73
+ * disembunyikan. Warna mengikuti lapis yang lebih ketat: DISCUSS/PLAN warning,
74
+ * ASK info, AUTO success.
68
75
  */
69
76
  export function paintFooterMode(mode: string, workMode?: string): string {
70
- const restrictive = workMode === "DISCUSS" || workMode === "PLAN"
71
- const label = restrictive ? `${workMode}·${mode}` : mode
72
- // Padding per KOLOM (bukan padEnd karakter): CJK/emoji = 2 kolom, dan
73
- // displayWidth sudah dipakai di bawah — konsisten satu penggaris.
74
- // Mode satu-baris: newline dari input tak terpercaya wajib dibuang agar tak
75
- // memecah frame lengket 2-baris chrome.ts.
77
+ const wm = !workMode || workMode === "EXECUTE" ? "BUILD" : workMode.toUpperCase()
78
+ const pm = permissionLabel(mode)
79
+ const restrictive = wm === "DISCUSS" || wm === "PLAN"
80
+ const label = `${wm} · ${pm}`
76
81
  const padded = padToWidth(sanitizeAnsiLine(label), MODE_WIDTH)
77
82
  if (restrictive) return c.warning(padded)
78
- return mode === "plan" ? c.warning(padded) : mode === "ask" ? c.info(padded) : c.success(padded)
83
+ return pm === "ASK" ? c.info(padded) : c.success(padded)
79
84
  }
80
85
 
81
86
  /** Spark glyph: redup saat idle, pulse putih↔abu saat busy (frame genap/ganjil). */
package/src/ui/i18n/en.ts CHANGED
@@ -145,11 +145,11 @@ export const en = {
145
145
  "help.keysLine": "Mouse wheel/PgUp/PgDn scroll (Shift = half) · /help keys = all shortcuts",
146
146
  "help.cHead": "Commands:",
147
147
  "help.cKeys":
148
- "Keys: Tab mode · ↑↓ history · Mouse wheel/PgUp/PgDn scroll · Ctrl+R search · Ctrl+D exit",
148
+ "Keys: Tab work-mode · Shift+Tab permission · ↑↓ history · Mouse wheel/PgUp/PgDn scroll · Ctrl+R search · Ctrl+D exit",
149
149
  "help.cMore": " /help keys = all shortcuts",
150
150
  "help.kHead": "Keyboard:",
151
151
  "help.k.submit": "submit",
152
- "help.k.cycleMode": "cycle permission mode",
152
+ "help.k.cycleMode": "cycle work mode",
153
153
  "help.k.history": "prompt history (in picker: navigate)",
154
154
  "help.k.mouse": "scroll transcript with mouse wheel",
155
155
  "help.k.scroll": "scroll transcript with PgUp/PgDn (Shift+ = half page)",
@@ -238,7 +238,7 @@ export const en = {
238
238
  "tui.modeLine": "mode: {m}",
239
239
  "tui.workModeUnknown": "unknown work mode: {a} — choices: {modes}",
240
240
  "tui.workModeLine": "work mode: {m}",
241
- "tui.workModeUsage": "usage: /work-mode <DISCUSS|PLAN|EXECUTE> — current: {m}",
241
+ "tui.workModeUsage": "usage: /work-mode <DISCUSS|PLAN|BUILD> — current: {m}",
242
242
  "tui.workModeUnavailable": "work mode is not available in this session",
243
243
  "tui.langLine": "lang: {v}",
244
244
  "tui.toolCall": "tool call: {v}",
package/src/ui/i18n/id.ts CHANGED
@@ -146,11 +146,11 @@ export const id: Record<MsgKey, string> = {
146
146
  "help.keysLine": "Mouse wheel/PgUp/PgDn gulir (Shift = ½) · /help tombol = semua pintasan",
147
147
  "help.cHead": "Perintah:",
148
148
  "help.cKeys":
149
- "Tombol: Tab mode · ↑↓ riwayat · Mouse wheel/PgUp/PgDn gulir · Ctrl+R cari · Ctrl+D keluar",
149
+ "Tombol: Tab work-mode · Shift+Tab izin · ↑↓ riwayat · Mouse wheel/PgUp/PgDn gulir · Ctrl+R cari · Ctrl+D keluar",
150
150
  "help.cMore": " /help tombol = semua pintasan",
151
151
  "help.kHead": "Papan tombol:",
152
152
  "help.k.submit": "kirim",
153
- "help.k.cycleMode": "putar mode izin",
153
+ "help.k.cycleMode": "putar work mode",
154
154
  "help.k.history": "riwayat prompt (di picker: navigasi)",
155
155
  "help.k.mouse": "gulir transkrip dengan mouse wheel",
156
156
  "help.k.scroll": "gulir transkrip dengan PgUp/PgDn (Shift+ = setengah halaman)",
@@ -239,7 +239,7 @@ export const id: Record<MsgKey, string> = {
239
239
  "tui.modeLine": "mode: {m}",
240
240
  "tui.workModeUnknown": "work mode tidak dikenal: {a} — pilihan: {modes}",
241
241
  "tui.workModeLine": "mode kerja: {m}",
242
- "tui.workModeUsage": "pemakaian: /work-mode <DISCUSS|PLAN|EXECUTE> — aktif: {m}",
242
+ "tui.workModeUsage": "pemakaian: /work-mode <DISCUSS|PLAN|BUILD> — aktif: {m}",
243
243
  "tui.workModeUnavailable": "work mode tidak tersedia di sesi ini",
244
244
  "tui.langLine": "lang: {v}",
245
245
  "tui.toolCall": "pemanggilan tool: {v}",
package/src/ui/tui/app.ts CHANGED
@@ -57,8 +57,10 @@ export interface TuiHost {
57
57
  /** Batalkan turn yang berjalan (Esc saat busy). */
58
58
  abort(): void
59
59
  copySelection(text: string): boolean
60
- /** Putar mode permission (Tab / Shift+Tab). */
61
- cycleMode(dir: 1 | -1): void
60
+ /** Putar WorkMode DISCUSS→PLAN→BUILD (Tab). */
61
+ cycleWorkMode(dir: 1 | -1): void
62
+ /** Toggle PermissionMode AUTO↔ASK (Shift+Tab). */
63
+ togglePermissionMode(): void
62
64
  /** Toggle compact / reasoning (Ctrl+O / Ctrl+T). */
63
65
  toggleCompact(): void
64
66
  toggleReasoning(): void
@@ -601,12 +603,12 @@ export class TuiApp {
601
603
  return
602
604
  }
603
605
  if (key.type === "tab") {
604
- this.host.cycleMode(1)
606
+ this.host.cycleWorkMode(1)
605
607
  this.paintCurrent()
606
608
  return
607
609
  }
608
610
  if (key.type === "shift-tab") {
609
- this.host.cycleMode(-1)
611
+ this.host.togglePermissionMode()
610
612
  this.paintCurrent()
611
613
  return
612
614
  }