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/cli/tui.ts CHANGED
@@ -24,27 +24,19 @@ import {
24
24
  } from "../src/presentation/projection.ts"
25
25
  import { redoLastCheckpoint, undoLastCheckpoint } from "../src/session/checkpoint.ts"
26
26
  import { renderSkill } from "../src/skills/loader.ts"
27
- import {
28
- getLastTurnTexts,
29
- MAX_COPY_TURNS,
30
- writeClipboardOsc52,
31
- } from "../src/ui/assistant/simple.ts"
27
+ import { MAX_COPY_TURNS, writeClipboardOsc52 } from "../src/ui/assistant/simple.ts"
32
28
  import type { UiBus } from "../src/ui/contract.ts"
33
29
  import { t } from "../src/ui/i18n/locale.ts"
34
30
  import { loadHistory } from "../src/ui/input/input.ts"
35
- import {
36
- clearCollapsedSections,
37
- collapsedSectionsSnapshot,
38
- sectionMinimized,
39
- setSectionMinimized,
40
- } from "../src/ui/render/collapse.ts"
41
- import { setCompactMode } from "../src/ui/render/detail.ts"
42
31
  import { formatUsd } from "../src/ui/render/money.ts"
43
- import { setReasoningVisible } from "../src/ui/render/reasoning.ts"
44
32
  import { c } from "../src/ui/render/theme.ts"
33
+ // [Area A · PROMPT 06] State UI milik SESI ini. TUI + printer linier sesi yang
34
+ // sama berbagi state (satu instance), sesi lain di proses yang sama tak
35
+ // tersentuh. Absen = instance default (fixture tes partial).
36
+ import { defaultUiState, type UiSessionState } from "../src/ui/session-state.ts"
45
37
  import { TuiApp, type TuiHost } from "../src/ui/tui/app.ts"
46
38
  import { Transcript } from "../src/ui/tui/transcript.ts"
47
- import { parseWorkModeValue } from "./args.ts"
39
+ import { displayWorkMode, parseWorkModeValue } from "./args.ts"
48
40
  import {
49
41
  BUILTIN_COMMANDS,
50
42
  type CommandContext,
@@ -55,9 +47,20 @@ import {
55
47
  } from "./commands.ts"
56
48
  import type { CliSession } from "./setup.ts"
57
49
 
58
- 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
59
55
  // /expand [id]: tanpa arg = semua entry store; dengan id = satu tool.
60
- const DRIVER_COMMANDS = ["/compact", "/thinking", "/expand [id]", "/minimize"]
56
+ const DRIVER_COMMANDS = [
57
+ "/compact",
58
+ "/thinking",
59
+ "/expand [id]",
60
+ "/minimize",
61
+ "/mode",
62
+ "/work-mode",
63
+ ]
61
64
 
62
65
  function fmtCtx(n: number): string | undefined {
63
66
  if (!Number.isFinite(n) || n <= 0) return undefined
@@ -67,6 +70,32 @@ function fmtCtx(n: number): string | undefined {
67
70
  return `${(n / 1000000).toFixed(1)}m`
68
71
  }
69
72
 
73
+ /**
74
+ * F-CTX-1: metrik usage footer (biaya + window %) dari angka NYATA, tanpa
75
+ * perkiraan. Kosong = tak ada data relevan (belum belanja / flag window tak
76
+ * disetel) — footer tak pernah menampilkan persentase/biaya palsu.
77
+ */
78
+ function fmtUsageMetrics(ctx: CliSession): string | undefined {
79
+ const cost: number | undefined = ctx.usage.getSession().cost
80
+ const windowTokens: number | undefined = ctx.contextWindowTokens
81
+ // P1.4: persentase footer = OCCUPANCY konteks saat ini, bukan total token
82
+ // yang sudah dibelanjakan sepanjang sesi. Memakai spend membuat footer
83
+ // mentok 100% setelah beberapa step meski konteks masih jauh di bawah window.
84
+ const used: number = ctx.session.contextTokens
85
+ const parts: string[] = []
86
+ if (cost !== undefined && Number.isFinite(cost) && cost > 0) parts.push(formatUsd(cost))
87
+ if (
88
+ windowTokens !== undefined &&
89
+ Number.isFinite(windowTokens) &&
90
+ windowTokens > 0 &&
91
+ Number.isFinite(used)
92
+ ) {
93
+ const pct = Math.min(100, Math.round((used / windowTokens) * 100))
94
+ parts.push(`${pct}%`)
95
+ }
96
+ return parts.length ? parts.join(" ") : undefined
97
+ }
98
+
70
99
  /**
71
100
  * Tangkap console.log/error selama `fn` → baris teks (tanpa warna liar:
72
101
  * caller yang mewarnai). Dipakai membungkus handleBuiltinCommand supaya
@@ -123,14 +152,17 @@ export async function runTui(ctx: CliSession): Promise<void> {
123
152
  schedulerObservability,
124
153
  } = ctx
125
154
  const { session } = ctx
155
+ // [Area A · PROMPT 06] State UI sesi. `runTui` juga dijalankan fixture tes
156
+ // dengan CliSession parsial — absen berarti pakai instance default.
157
+ const ui: UiSessionState = ctx.uiState ?? defaultUiState
126
158
  const getPresentationSnapshot = () =>
127
159
  typeof ctx.getPresentationSnapshot === "function"
128
160
  ? ctx.getPresentationSnapshot()
129
161
  : { activities: [], turns: [] }
130
162
 
131
163
  let mode: string = permissions?.getMode() ?? permissionMode ?? "auto"
132
- if (process.env.MINICODE_COMPACT === undefined) setCompactMode(true)
133
- if (process.env.MINICODE_MINIMIZE_TOOL === undefined) setSectionMinimized("tool", true)
164
+ if (process.env.MINICODE_COMPACT === undefined) ui.setCompactMode(true)
165
+ if (process.env.MINICODE_MINIMIZE_TOOL === undefined) ui.setSectionMinimized("tool", true)
134
166
  let warned80 = false
135
167
  let abort: AbortController | null = null
136
168
 
@@ -146,6 +178,8 @@ export async function runTui(ctx: CliSession): Promise<void> {
146
178
  const transcript = new Transcript(session.events as unknown as UiBus, {
147
179
  getSnapshot: getPresentationSnapshot,
148
180
  onPresentationEvent: ctx.onPresentationEvent,
181
+ // [Area A · PROMPT 06] State sesi yang sama dengan printer linier.
182
+ uiState: ui,
149
183
  policy: {
150
184
  describeActivity,
151
185
  matchTurn: matchTurnBySummary,
@@ -184,6 +218,14 @@ export async function runTui(ctx: CliSession): Promise<void> {
184
218
  usage,
185
219
  skills: allLoadedSkills,
186
220
  toolsCount: sessionTools.length,
221
+ // P1.2: dua dimensi selalu terbaca live di /status — bukan snapshot boot.
222
+ // [mode-architecture] /status memakai nilai PRODUK (BUILD/AUTO/ASK).
223
+ get workMode() {
224
+ return displayWorkMode(workModeControl?.getWorkMode() ?? "EXECUTE")
225
+ },
226
+ get permissionMode() {
227
+ return (permissions?.getMode() ?? mode).toUpperCase()
228
+ },
187
229
  providerHint: cfg.providers[0]?.providerHint,
188
230
  setModelOverride: (m) => persistModelChoice(m, modelRef),
189
231
  // Spawn anak stdio-inherit (/sessions <id>): keluar alt-screen + cooked
@@ -226,14 +268,24 @@ export async function runTui(ctx: CliSession): Promise<void> {
226
268
  return all.filter((t) => t.startsWith(line))
227
269
  }
228
270
 
229
- const cycleMode = (dir: 1 | -1): void => {
230
- const idx = (MODES as readonly string[]).indexOf(mode)
231
- // allow-all hanya via flag --allow-all (paritas REPL).
232
- let next = MODES[(idx + dir + MODES.length) % MODES.length]!
233
- 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)
234
288
  mode = next
235
- if (permissions) permissions.setMode(mode as (typeof MODES)[number])
236
- else mode = permissionMode ?? mode
237
289
  }
238
290
 
239
291
  async function runBuiltin(
@@ -343,8 +395,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
343
395
  function helpConcise(): void {
344
396
  // Diturunkan dari registry (BUILTIN + driver) — perintah baru tak bisa
345
397
  // hilang dari /help diam-diam (satu sumber, bukan daftar hardcode).
398
+ // Set menjaga urutan deklarasi sekaligus mencegah duplikasi saat perintah
399
+ // driver terdaftar di completion (DRIVER_COMMANDS) dan help (DRIVER_HELP_COMMANDS).
346
400
  const builtin = BUILTIN_COMMANDS.map((b) => `/${b.name}`).join(" ")
347
- const driver = [...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)].join(" ")
401
+ const driver = [
402
+ ...new Set([...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)]),
403
+ ].join(" ")
348
404
  transcript.pushInfo([
349
405
  t("help.cHead"),
350
406
  ` ${builtin}`,
@@ -362,7 +418,10 @@ export async function runTui(ctx: CliSession): Promise<void> {
362
418
  }
363
419
 
364
420
  async function copyLastTurn(count: number): Promise<void> {
365
- const turns = getLastTurnTexts(count)
421
+ // [Area A · PROMPT 06] Buffer /copy milik SESI ini (bukan singleton modul)
422
+ // — sesi lain di proses yang sama tak ikut tercampur.
423
+ const turns = ui
424
+ .getLastTurnTexts(count)
366
425
  .map((turn) => turn.trim())
367
426
  .filter(Boolean)
368
427
  const txt = turns.join("\n\n").trim()
@@ -400,33 +459,35 @@ export async function runTui(ctx: CliSession): Promise<void> {
400
459
  app.clearView()
401
460
  return
402
461
  }
462
+ // [mode-architecture] /mode = PermissionMode (persetujuan AUTO/ASK) SAJA.
403
463
  if (name === "mode") {
404
464
  if (args) {
405
- if (!(MODES as readonly string[]).includes(args)) {
406
- 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" }))])
407
468
  return
408
469
  }
409
- mode = args
410
- permissions?.setMode(args as (typeof MODES)[number])
470
+ mode = norm
471
+ permissions?.setMode(norm as (typeof PERMISSION_MODES)[number])
411
472
  } else {
412
- cycleMode(1)
473
+ togglePermissionMode()
413
474
  }
414
- transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode }))])
475
+ transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode.toUpperCase() }))])
415
476
  return
416
477
  }
417
- // P12 S2.2 Slice 5 - WorkMode (lapis intent di ATAS permission mode).
418
- // Aksi operator EKSPLISIT: hanya command ini yang menggeser WorkMode.
419
- // 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.
420
480
  if (name === "work-mode") {
421
481
  const current = workModeControl?.getWorkMode() ?? "EXECUTE"
482
+ const currentDisplay = displayWorkMode(current)
422
483
  if (!args) {
423
- transcript.pushInfo([c.muted(t("tui.workModeUsage", { m: current }))])
484
+ transcript.pushInfo([c.muted(t("tui.workModeUsage", { m: currentDisplay }))])
424
485
  return
425
486
  }
426
487
  const next = parseWorkModeValue(args)
427
488
  if (!next) {
428
489
  transcript.pushInfo([
429
- c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN, EXECUTE" })),
490
+ c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN, BUILD" })),
430
491
  ])
431
492
  return
432
493
  }
@@ -437,7 +498,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
437
498
  return
438
499
  }
439
500
  workModeControl.setWorkMode(next)
440
- transcript.pushInfo([c.muted(t("tui.workModeLine", { m: next }))])
501
+ transcript.pushInfo([c.muted(t("tui.workModeLine", { m: displayWorkMode(next) }))])
441
502
  return
442
503
  }
443
504
  if (name === "lang") {
@@ -462,20 +523,20 @@ export async function runTui(ctx: CliSession): Promise<void> {
462
523
  }
463
524
  if (name === "compact") {
464
525
  const next = args === "" ? undefined : args === "on" || args === "1"
465
- const compact = setCompactMode(next)
526
+ const compact = ui.setCompactMode(next)
466
527
  transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
467
528
  return
468
529
  }
469
530
  if (name === "thinking") {
470
531
  const next = args === "" ? undefined : args === "on" || args === "1"
471
- const vis = setReasoningVisible(next)
532
+ const vis = ui.setReasoningVisible(next)
472
533
  transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
473
534
  return
474
535
  }
475
536
  if (name === "expand") {
476
537
  const sections = args ? ctx.expandContent(args) : ctx.expandAllContent()
477
- const views = args ? [] : collapsedSectionsSnapshot()
478
- if (!args) clearCollapsedSections()
538
+ const views = args ? [] : ui.collapsedSectionsSnapshot()
539
+ if (!args) ui.clearCollapsedSections()
479
540
  if (!sections.length && !views.length) {
480
541
  transcript.pushInfo([c.muted(t("tui.expandEmpty"))])
481
542
  return
@@ -501,15 +562,15 @@ export async function runTui(ctx: CliSession): Promise<void> {
501
562
  if (name === "minimize") {
502
563
  const arg = args.trim().toLowerCase()
503
564
  let next: boolean | undefined
504
- if (arg === "") next = !(sectionMinimized("tool") && sectionMinimized("answer"))
565
+ if (arg === "") next = !(ui.sectionMinimized("tool") && ui.sectionMinimized("answer"))
505
566
  else if (arg === "on" || arg === "1") next = true
506
567
  else if (arg === "off" || arg === "0") next = false
507
568
  else {
508
569
  transcript.pushInfo([c.muted(t("tui.minUse"))])
509
570
  return
510
571
  }
511
- setSectionMinimized("tool", next)
512
- setSectionMinimized("answer", next)
572
+ ui.setSectionMinimized("tool", next)
573
+ ui.setSectionMinimized("answer", next)
513
574
  transcript.pushInfo([c.muted(t(next ? "tui.sectionsMin" : "tui.sectionsExp"))])
514
575
  return
515
576
  }
@@ -592,6 +653,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
592
653
  model: modelRef.current ?? cfg.providers[0]?.models[0] ?? t("tui.noModel"),
593
654
  cwd: cwd ?? process.cwd(),
594
655
  context: fmtCtx(session.contextTokens),
656
+ metrics: fmtUsageMetrics(ctx),
595
657
  },
596
658
  busy: abort != null,
597
659
  }
@@ -611,15 +673,18 @@ export async function runTui(ctx: CliSession): Promise<void> {
611
673
  abort: () => {
612
674
  abort?.abort()
613
675
  },
614
- cycleMode: (dir) => {
615
- cycleMode(dir)
676
+ cycleWorkMode: (dir) => {
677
+ cycleWorkMode(dir)
678
+ },
679
+ togglePermissionMode: () => {
680
+ togglePermissionMode()
616
681
  },
617
682
  toggleCompact: () => {
618
- const compact = setCompactMode()
683
+ const compact = ui.setCompactMode()
619
684
  transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
620
685
  },
621
686
  toggleReasoning: () => {
622
- const vis = setReasoningVisible()
687
+ const vis = ui.setReasoningVisible()
623
688
  transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
624
689
  },
625
690
  }
@@ -227,6 +227,15 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
227
227
  tetap pada ledger tool, status tool final memakai glyph + kata
228
228
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
229
229
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
230
+ **Grup anak (F-AGENT-1):** tool anak yang punya identitas run
231
+ (`childSessionId`/`runId` — dari `ChildSessionLink`) tampil sebagai baris
232
+ run sendiri, diindented `↳ <marker> <tool> <target> <status>` dengan
233
+ marker `run_<8>`/`sub_<8>`; anak paralel tak lagi(dir) satukan jadi satu
234
+ hitungan. Tool anak yang HANYA punya `parentToolCallId` (grouping legacy,
235
+ tanpa identitas run) tetap ditelan sebagai hitungan induk `n child tools`
236
+ — `parentToolCallId` = taut ke pemanggil, bukan identitas run, jadi dua
237
+ makna itu tak boleh disamakan. Baris running anak memakai aturan yang
238
+ sama (marker per run).
230
239
 
231
240
  18. Prompt multiline (Ctrl+J newline), histori memori-sesi (tak persist ke
232
241
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
@@ -319,24 +328,48 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
319
328
  — subcommand lain menerima args mentah. Invarian ini tidak mengubah
320
329
  semantik, aksi, atau exit code masing-masing aksi; yang berubah hanya
321
330
  invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
322
- 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2)** — dua
331
+ 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
323
332
  dimensi yang BERJALAN BERSAMA, bukan pengganti:
324
- **Nilai:** `DISCUSS` (read-only penuh) · `PLAN` (ceiling rencana) ·
325
- `EXECUTE` (tanpa ceiling tambahan). Default `EXECUTE` = perilaku lama
326
- (kompatibel: sesi tanpa WorkMode yang eksplisit tetap EXECUTE).
327
- **Gerbang penolakan:** permission handler tetap satu-satunya yang menentukan
328
- keamanan eksekusi. WorkMode hanya MEMASANG CEILING di atasnya; ia tidak
329
- pernah memperluas kewenangan permission mode dasar (INV-WM1).
333
+ **Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
334
+ lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
335
+ (ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
336
+ approval prompt + ekstra rencana bila diizinkan PM) · `EXECUTE` (tanpa
337
+ ceiling tambahan). Default `EXECUTE` = perilaku lama (kompatibel: sesi baru
338
+ tanpa WorkMode eksplisit tetap EXECUTE).
339
+ **Gerbang penolakan & side-effect ceiling:** permission handler tetap
340
+ satu-satunya yang menentukan keamanan eksekusi. WorkMode hanya MEMASANG
341
+ CEILING di atasnya; ia tidak pernah memperluas kewenangan permission mode
342
+ dasar (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
343
+ hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
344
+ ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
345
+ serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
330
346
  **Command `/work-mode <DISCUSS|PLAN|EXECUTE>`:** aksi operator EKSPLISIT.
331
347
  Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
332
348
  kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
333
349
  (handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
334
350
  diam-diam tampak berubah. Transisi berlaku pada SESI YANG SEDANG
335
351
  BERJALAN: ceiling permission dievaluasi per pemanggilan tool, daftar tool
336
- yang dilihat model ikut turun/naik, hooks dievaluasi terhadap WorkMode
337
- aktif, dan delegasi berikutnya mewarisi WorkMode parent yang aktif.
338
- WorkMode TIDAK bisa dinaikkan otomatis oleh model, anak, atau argumen
339
- delegasi.
352
+ dan instruksi system prompt yang dilihat model ikut turun/naik, hooks/verify
353
+ dievaluasi terhadap WorkMode aktif, dan delegasi berikutnya mewarisi
354
+ WorkMode parent yang aktif. WorkMode TIDAK bisa dinaikkan otomatis oleh
355
+ model, anak, atau argumen delegasi.
356
+ **Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
357
+ (`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
358
+ (`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
359
+ sesi (baris legacy tanpa `work_mode` kembali ke default `EXECUTE`) dan
360
+ composition root menulis SATU baris stderr human-facing
361
+ (`[resume] WorkMode <MODE> restored from session...` atau notice override/
362
+ legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
363
+ keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
364
+ terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
365
+ **Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
366
+ footer (`<WorkMode>·<permission mode>`), di one-shot/exec linear lewat SATU
367
+ baris stderr human-facing `[work-mode] <MODE> …` hanya saat WorkMode ≠
368
+ EXECUTE (EXECUTE = default, tanpa baris), dan di `exec --json` lewat field
369
+ terstruktur `summary.workMode` (selalu hadir, termasuk EXECUTE) — bukan teks
370
+ dekoratif. ACP memakai `params.workMode` (terstruktur) dan tak menambah baris
371
+ dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
372
+ vs `/mode`/`--plan`) dan dari status sesi.
340
373
  **Pemisahan dari permission mode:** Tab/Shift+Tab dan `/mode` TETAP
341
374
  khusus permission mode — WorkMode tak masuk siklus Tab. Permission mode
342
375
  yang memutuskan allow/deny per tool; WorkMode memilih postur
@@ -369,7 +402,9 @@ belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
369
402
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
370
403
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
371
404
  Projection V2: `› name target … running`, ledger status ber-glyph/kata,
372
- retry/grup anak, ringkasan turn, dan marker evict sesuai flag ·
405
+ retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
406
+ identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
407
+ sesuai flag ·
373
408
 
374
409
  `Esc` saat turn = abort (+ hint sekali); busy = input beku total ·
375
410
  Mouse wheel = scroll transkrip, PgUp/PgDn = scroll, Shift+PgUp/PgDn = setengah
@@ -430,17 +465,40 @@ panjang).
430
465
  - `test/tui-transcript.test.ts` — I7/I12/I17/I22 (ledger satu baris per tool, cap 5000 + marker evict, `total()` monotonik kebal evict, viewport, thinking minimized/expanded).
431
466
  - `test/presentation-projections.test.ts` — I12/I17/I32 (projection
432
467
  snapshot, running/elapsed, status terminal, retry/child grouping, summary,
433
- marker evict + `total()` monotonik, dan parity flag OFF).
468
+ marker evict + `total()` monotonik, dan parity flag OFF) + F-AGENT-1
469
+ (baris per-run `↳ run_<8>`/`sub_<8>` untuk anak ber-identitas run; tiga anak
470
+ paralel = tiga baris; anak tanpa identitas run tetap satu baris ledger induk
471
+ `n child tools`) + F-TASK-1 (baris ledger `t<n> <status> parent=… dependsOn=[…]
472
+ r<rev>`; jalur **linear** merender baris sama + proyeksi `normal`
473
+ mempertahankan notice task — PROMPT 06 Area D).
434
474
  - `test/presentation-linear-acp.test.ts` — I33 (linear projection
435
- status/duration/receipt dan lifecycle ACP terstruktur; parity policy-vs-legacy).
475
+ status/duration/receipt dan lifecycle ACP terstruktur; parity policy-vs-legacy)
476
+ + PROMPT 06 Area D (`task.status` → baris ledger linear **dan** envelope ACP
477
+ berfield `taskId`/`status`/`parentId`/`dependsOn`/`revision`).
436
478
  - `test/presentation-policy.test.ts` — I32/I33 (seleksi node per mode, envelope
437
- machine, digest divergensi; purity tanpa clock/IO).
479
+ machine, digest divergensi; purity tanpa clock/IO) + PROMPT 06 Area D
480
+ (notice `task.status` **ikut mode `normal`** dengan field terstruktur utuh).
438
481
  - `test/writer-inventory.test.ts` — OAP-008 (setiap writer langsung terdaftar
439
482
  dengan owner; jumlah tak boleh naik diam-diam).
440
483
  - `test/exec-json-envelope.test.ts` + `test/cli-session.test.ts` (envelope
441
484
  machine) — I28/I33/I34 (summary berversi, tanpa ANSI/secret, tanpa raw
442
485
  kernel; P11.2 scoping prompt: flag-mendahului vs `exec`-dahulu identik,
443
486
  kata `exec` milik user tetap utuh).
487
+ - PROMPT 06 Area A — `test/ui-instance-isolation.test.ts`: state renderer
488
+ per-instans (dua sesi nyata; env = bootstrap saja).
489
+ - PROMPT 06 Area B — `test/approval-integrity.test.ts`: binding args-hash +
490
+ fingerprint target difoto sebelum prompt dan diverifikasi di barrier efek
491
+ (deny `"stale"` bila berubah), termasuk jalur kernel nyata.
492
+ - PROMPT 06 Area C — `test/daemon-stream-phase.test.ts`: `subscribed.phase` +
493
+ `tail_marker.phase` dari latch per-langganan; badge `" [replay]"`.
494
+ - PROMPT 06 Area E — `test/memory-consistency.test.ts`: degradasi vector
495
+ terlihat di hasil tool, revoke provenance AND (fail-closed), reconcile
496
+ mengadopsi (bukan menghapus) vector-only, fakta panjang utuh, supersession
497
+ menarik baris lama, lupa menghapus entri multi-chunk utuh, cap per-entri,
498
+ validasi respons embedding.
499
+ - PROMPT 06 Area F — `test/ci-glob-expansion.test.ts`: `ci-windows` memakai
500
+ `shell: bash` (pwsh tak mengekspansi glob → suite p15..p24 lolos diam-diam),
501
+ pola mati dihapus, subset p15..p24 hadir di kedua job.
444
502
 
445
503
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
446
504
  anti-hantu).
@@ -457,19 +515,22 @@ panjang).
457
515
  termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; label
458
516
  footer `PLAN·auto`/`DISCUSS·auto`).
459
517
  - `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
460
- handler PM: 18 sel matriks, gerbang approval `PLAN × auto/ask`, `describeDenial`
461
- per pemilik keputusan, `always`/K-1 tetap utuh, `__setMode` tak mencabut
462
- ceiling).
518
+ handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
519
+ `web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
520
+ keputusan, `always`/K-1 tetap utuh, `__setMode` tak mencabut ceiling).
463
521
  - `test/work-mode-tool-visibility.test.ts` — I35 (visibilitas tool = irisan
464
- permission mode ∧ WorkMode; `PLAN × readonly` tak memperluas readonly;
522
+ permission mode ∧ WorkMode; `DISCUSS` tepat 16 tool baca lokal tanpa network
523
+ read; `PLAN × readonly/allowlist` tak memperluas di luar 18 `READONLY_TOOL_NAMES`;
465
524
  tool MCP ikut dibatasi).
466
- - `test/work-mode-hooks.test.ts` — I35 (hooks: `DISCUSS` menahan, `PLAN`/
467
- `EXECUTE` mengikuti permission mode; pemanggil lama tanpa WorkMode kompatibel).
525
+ - `test/work-mode-hooks.test.ts` — I35 (hooks: `DISCUSS` dan `PLAN` menahan
526
+ semua `.minicode/hooks/*` di seluruh `PermissionMode`; hanya `EXECUTE` yang
527
+ mengikuti permission mode; pemanggil lama tanpa WorkMode kompatibel).
468
528
  - `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
469
529
  tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
470
- - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > default
471
- EXECUTE; nilai invalid → EXECUTE + peringatan; ACP `workMode` terpisah dari
472
- `mode`).
530
+ - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
531
+ resume > default EXECUTE; nilai invalid → EXECUTE + peringatan; `--verify`
532
+ ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
533
+ `workMode` parity).
473
534
  - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
474
535
  editing/busy, dots clock, timer, cursor, resize, popup). *Klausul "satu baris
475
536
  kosong memisahkan composer dari footer" TIDAK punya assertion — lihat
@@ -556,6 +617,11 @@ panjang).
556
617
  sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
557
618
  bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
558
619
  Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
620
+ Verifikasi **exit code** (I28) hanya dijalankan di POSIX: Windows ConPTY
621
+ terbukti kadang melaporkan `exitCode: undefined` untuk anak yang keluar via
622
+ PTY interaktif (satu probe sukses TIDAK menjamin run berikutnya), sehingga
623
+ test di-SKIP beralasan di Windows — bukan diluluskan dan bukan dianggap
624
+ "berhasil".
559
625
  Jalur mouse SGR punya capability gate (`ptySgrMouseDelivered()`): transport
560
626
  yang TAK mengantarkan byte SGR → SKIP beralasan; probe tak konklusif → SKIP
561
627
  dengan alasan "tak konklusif" (BUKAN bukti SGR tak didukung); di CI Linux
@@ -577,3 +643,4 @@ kata-kata di sini TIDAK menutup gap.
577
643
  | I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
578
644
  | I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
579
645
  | I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
646
+ | I3 — tak ada byte stdout bocor selama alternate-screen | Terimplementasi (TUI menulis UI ke stderr; stdout khusus pipe/envelope) | Belum ada test PTY yang meng-assert "stream stdout kosong selama alt-screen aktif" (hanya fake-TTY). Juga: job `ci-windows` TIDAK pernah menjalankan `pty*.test.ts` — suite PTY hanya tercapai lewat glob `test/p*.test.ts` di job ubuntu. |
package/docs/agents.md CHANGED
@@ -5,16 +5,16 @@
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` | Read-only + `todo_read` (baca rencana parent), tetap tanpa mutasi dan tanpa `todo_write` |
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
- Restriksi anak (selalu, tanpa kecuali): **tanpa** MCP, `git_commit`, memory-tulis, todo-tulis, job background, nesting (anak tidak bisa mendelegasi lagi). Plan-parent dipaksa explore saat mendelegasi.
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
 
19
19
  ## Kenapa dibatasi
20
20
 
@@ -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.