minicode-ai 0.14.6 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/cli/args.ts +20 -8
  2. package/cli/commands/exec.ts +14 -12
  3. package/cli/commands.ts +33 -17
  4. package/cli/index.ts +25 -3
  5. package/cli/router.ts +22 -9
  6. package/cli/setup.ts +20 -5
  7. package/cli/tui.ts +73 -14
  8. package/docs/CONTROL-PLANE-MAP.md +1 -1
  9. package/docs/SUMMARY.md +1 -1
  10. package/docs/TERMINAL_CONTRACT.md +37 -12
  11. package/docs/architecture.md +1 -0
  12. package/docs/choosing-mode.md +3 -1
  13. package/docs/cli.md +7 -5
  14. package/docs/config.md +1 -1
  15. package/docs/environment.md +3 -1
  16. package/docs/getting-started.md +1 -1
  17. package/docs/memory-sessions.md +2 -2
  18. package/docs/repl.md +6 -3
  19. package/docs/security-model.md +3 -1
  20. package/package.json +1 -1
  21. package/scripts/vendor-overlays/minicode-context.patch +1 -1
  22. package/src/app/mentions.ts +1 -1
  23. package/src/app/rag-layer.ts +11 -2
  24. package/src/app/session.ts +92 -7
  25. package/src/constants.ts +1 -1
  26. package/src/daemon/client.ts +11 -6
  27. package/src/daemon/control.ts +2 -9
  28. package/src/daemon/resource.ts +5 -4
  29. package/src/lib/keystore.ts +11 -9
  30. package/src/lib/net.ts +8 -3
  31. package/src/lib/safe-open.ts +29 -5
  32. package/src/lib/trusted-exec.ts +4 -1
  33. package/src/lsp/client.ts +9 -10
  34. package/src/mcp/server.ts +17 -7
  35. package/src/memory/files.ts +2 -1
  36. package/src/memory/vector.ts +25 -16
  37. package/src/policy/bash-guard.ts +33 -11
  38. package/src/policy/bpe.ts +110 -0
  39. package/src/policy/compaction.ts +33 -6
  40. package/src/policy/context-window.ts +19 -0
  41. package/src/policy/context.ts +34 -8
  42. package/src/policy/jail.ts +48 -3
  43. package/src/policy/no-progress.ts +15 -8
  44. package/src/policy/permission.ts +24 -1
  45. package/src/policy/tokenizer-registry.ts +104 -0
  46. package/src/policy/usage.ts +20 -13
  47. package/src/policy/verifier.ts +7 -4
  48. package/src/policy/work-mode.ts +9 -5
  49. package/src/presentation/adapter.ts +7 -3
  50. package/src/presentation/projection.ts +10 -2
  51. package/src/providers/anthropic.ts +13 -3
  52. package/src/providers/responses.ts +16 -6
  53. package/src/runtime/capability.ts +22 -4
  54. package/src/runtime/execution-journal.ts +13 -7
  55. package/src/runtime/production-execution.ts +4 -3
  56. package/src/sandbox/os.ts +4 -3
  57. package/src/session/checkpoint.ts +29 -4
  58. package/src/session/persistence.ts +21 -10
  59. package/src/task/autonomous-context.ts +0 -1
  60. package/src/task/scheduler-observability.ts +1 -0
  61. package/src/tools/git.ts +22 -4
  62. package/src/tools/lsp.ts +10 -8
  63. package/src/tools/web_fetch.ts +6 -2
  64. package/src/tools/web_search.ts +2 -1
  65. package/src/ui/assistant/simple.ts +9 -3
  66. package/src/ui/contract.ts +4 -0
  67. package/src/ui/footer.ts +18 -6
  68. package/src/ui/i18n/en.ts +13 -2
  69. package/src/ui/i18n/id.ts +13 -2
  70. package/src/ui/render/diff.ts +14 -5
  71. package/src/ui/render/highlight.ts +4 -4
  72. package/src/ui/render/markdown.ts +12 -5
  73. package/src/ui/render/session-summary.ts +50 -0
  74. package/src/ui/render/table-grid.ts +134 -6
  75. package/src/ui/render/theme.ts +17 -0
  76. package/src/ui/render/width.ts +89 -2
  77. package/src/ui/runtime/screen.ts +16 -15
  78. package/src/ui/session-state.ts +27 -1
  79. package/src/ui/tui/transcript.ts +90 -18
  80. package/vendor/minicore/VENDOR.md +3 -3
  81. package/vendor/minicore/src/core/loop.ts +1 -1
package/cli/args.ts CHANGED
@@ -271,24 +271,36 @@ export function readPrompt(): Promise<string> {
271
271
  return new Promise((resolve) => {
272
272
  let data = ""
273
273
  let done = false
274
+ const onData = (c: string | Buffer) => {
275
+ data += String(c)
276
+ }
277
+ const onEnd = () => {
278
+ if (!done) {
279
+ done = true
280
+ clearTimeout(t)
281
+ cleanup()
282
+ resolve(data.trim())
283
+ }
284
+ }
285
+ const cleanup = () => {
286
+ process.stdin.off("data", onData)
287
+ process.stdin.off("end", onEnd)
288
+ }
274
289
  const t = setTimeout(() => {
275
290
  if (!done) {
276
291
  done = true
292
+ cleanup()
277
293
  resolve("")
278
294
  }
279
295
  }, 500)
280
296
  process.stdin.setEncoding("utf8")
281
- process.stdin.on("data", (c) => (data += c))
282
- process.stdin.on("end", () => {
283
- if (!done) {
284
- done = true
285
- clearTimeout(t)
286
- resolve(data.trim())
287
- }
288
- })
297
+ process.stdin.on("data", onData)
298
+ process.stdin.on("end", onEnd)
289
299
  // if stdin already ended
290
300
  if (process.stdin.readableEnded) {
301
+ done = true
291
302
  clearTimeout(t)
303
+ cleanup()
292
304
  resolve("")
293
305
  }
294
306
  })
@@ -314,6 +314,20 @@ export async function handleExec(
314
314
  else process.stderr.write(`${msg}\n`)
315
315
  process.exit(1)
316
316
  }
317
+ unsubMachine()
318
+ unsubText()
319
+ await ctx.persistCurrent(ue)
320
+ // P2.2: histori yang tak durable = kegagalan jujur (bukan exit 0). Diperiksa
321
+ // SEBELUM menulis machineSummary(true) agar stdout JSONL tidak pernah
322
+ // memancarkan dua summary terminal yang saling bertentangan (ok:true lalu ok:false).
323
+ if (ctx.isWriterStale()) {
324
+ const msg = `[writer] stale writer, history NOT durable: ${ctx.writerStaleNote()}`
325
+ if (jsonMode)
326
+ writeMachineLine(JSON.stringify(machineFailure(effectivePrompt, new Error(msg))))
327
+ else process.stderr.write(`${msg}\n`)
328
+ await ctx.close()
329
+ process.exit(1)
330
+ }
317
331
  // Ringkasan memakai total SESI (ue), bukan turn terakhir: dengan --verify
318
332
  // (multi-turn + reset antar-siklus) angka turn mengecilkan pemakaian nyata.
319
333
  if (jsonMode) {
@@ -363,18 +377,6 @@ export async function handleExec(
363
377
  `\n[exec] done model=${ctx.modelRef.current} steps=${ctx.session.state.stepCount} tokens=${ue.totalTokens} ${Date.now() - t0}ms\n`,
364
378
  )
365
379
  }
366
- unsubMachine()
367
- unsubText()
368
- await ctx.persistCurrent(ue)
369
- // P2.2: histori yang tak durable = kegagalan jujur (bukan exit 0).
370
- if (ctx.isWriterStale()) {
371
- const msg = `[writer] stale writer, history NOT durable: ${ctx.writerStaleNote()}`
372
- if (jsonMode)
373
- writeMachineLine(JSON.stringify(machineFailure(effectivePrompt, new Error(msg))))
374
- else process.stderr.write(`${msg}\n`)
375
- await ctx.close()
376
- process.exit(1)
377
- }
378
380
  await ctx.close()
379
381
  process.exit(0)
380
382
  } catch (e) {
package/cli/commands.ts CHANGED
@@ -163,14 +163,28 @@ export const DRIVER_HELP_COMMANDS: BuiltinCommand[] = [
163
163
  { name: "scheduler", args: "[status|run|stop]", descKey: "help.desc.scheduler" },
164
164
  ]
165
165
 
166
- /** Pintasan papan tombol TUI — didokumentasikan di /help, bukan hanya di kode. */
166
+ /** Grup kurasi untuk /help: kategori semantik (bukan urutan registrasi). Dipakai
167
+ * render full help supaya mudah dipindai; nama di sini harus 1:1 dengan isi
168
+ * BUILTIN_COMMANDS + DRIVER_HELP_COMMANDS. */
169
+ const HELP_GROUPS: readonly { key: MsgKey; names: readonly string[] }[] = [
170
+ {
171
+ key: "help.gGeneral",
172
+ names: ["help", "status", "sessions", "history", "clear", "copy", "init", "exit"],
173
+ },
174
+ { key: "help.gModel", names: ["model", "provider", "sync"] },
175
+ { key: "help.gMode", names: ["mode", "work-mode", "undo", "redo", "lang"] },
176
+ { key: "help.gTask", names: ["scheduler"] },
177
+ ]
178
+
179
+ /** Pintasan papan tombol TUI — didokumentasikan di /help keys, bukan hanya kode. */
167
180
  const KEYBOARD_HELP: [string, MsgKey][] = [
168
181
  ["enter", "help.k.submit"],
169
- ["tab / shift+tab", "help.k.cycleMode"],
182
+ ["tab", "help.k.workMode"],
183
+ ["shift+tab", "help.k.permission"],
170
184
  ["up / down", "help.k.history"],
171
185
  ["mouse wheel", "help.k.mouse"],
172
186
  ["pgup / pgdn", "help.k.scroll"],
173
- ["home / end (prompt)", "help.k.jumpTop"],
187
+ ["home / end (empty prompt)", "help.k.jumpTop"],
174
188
  ["left / right", "help.k.move"],
175
189
  ["home / end", "help.k.jump"],
176
190
  ["delete", "help.k.delChar"],
@@ -463,28 +477,30 @@ export async function handleBuiltinCommand(
463
477
 
464
478
  switch (cmd) {
465
479
  case "help": {
466
- // Ringkas: perintah utama + skill + pintasan yang paling sering dipakai.
467
- // /help penuh tidak muat di layar pendek, jadi
468
- // pintasan lengkap dipindah ke `/help tombol`.
469
- const wantKeys = /^(tombol|keys?|keyboard)$/i.test(args)
470
- if (wantKeys) {
480
+ // /help keys|tombol = pintasan keyboard; selain itu (termasuk /help full,
481
+ // /help all, atau /help kosong dari non-TTY) = full help terkelompok.
482
+ // Satu pemanggilan cetak PER BARIS: TUI (runBuiltin) menangkap panggilan
483
+ // per baris, dan test juga menangkap per panggilan — inventory writer
484
+ // menghitung literal cetak ini (+1 untuk header grup).
485
+ if (/^(tombol|keys?|keyboard)$/i.test(args.trim())) {
471
486
  console.log(`\n${t("help.kHead")}`)
472
487
  for (const [key, keyDesc] of KEYBOARD_HELP) {
473
- console.log(` ${pad(key, 22)}${t(keyDesc)}`)
488
+ console.log(` ${pad(key, 24)}${t(keyDesc)}`)
474
489
  }
475
490
  console.log("")
476
491
  return { handled: true }
477
492
  }
493
+ const all = new Map([...BUILTIN_COMMANDS, ...DRIVER_HELP_COMMANDS].map((b) => [b.name, b]))
478
494
  console.log(`\n${t("help.head")}`)
479
- for (const b of [...BUILTIN_COMMANDS, ...DRIVER_HELP_COMMANDS]) {
480
- if (b.hidden) continue
481
- const withArgs = b.args ? `${b.name} ${b.args}` : b.name
482
- console.log(` ${pad(`/${withArgs}`, 25)} ${t(b.descKey)}`)
495
+ for (const group of HELP_GROUPS) {
496
+ console.log(` ${t(group.key)}`)
497
+ for (const name of group.names) {
498
+ const b = all.get(name)
499
+ if (!b || b.hidden) continue
500
+ const withArgs = b.args ? `${b.name} ${b.args}` : b.name
501
+ console.log(` ${pad(`/${withArgs}`, 26)} ${t(b.descKey)}`)
502
+ }
483
503
  }
484
- // Ringkas: perintah utama + skill + pintasan yang paling sering dipakai.
485
- // Panjang baris di bawah ≤80 kolom (dijaga test) dan tak boleh menyebut
486
- // /help tombol (juga dijaga test) — Ctrl+R satu-satunya yang paling
487
- // sering dicari yang muat setelah Enter/Tab/Shift+Tab.
488
504
  console.log(`\n${t("help.keysLine")}\n`)
489
505
  return { handled: true }
490
506
  }
package/cli/index.ts CHANGED
@@ -467,9 +467,10 @@ const enterRepl = interactive || (!prompt && process.stdin.isTTY)
467
467
  // versi baru (tak pernah kembali bila restart). Tampilkan spinner 1.8 dtk
468
468
  // agar tidak terlihat hang — budget tetap, hanya UX.
469
469
  // Spinner transient HANYA lewat ownership tunggal (src/ui/runtime/spinner) —
470
- // tulis mentah ke stderr melewati arbitrase statusline.ts: pesan [warn] lain
471
- // dihapus oleh tick berikutnya, dan frame-nya bisa menghapus baris layar
472
- // interaktif yang sedang menunggu input (wizard setup pertama).
470
+ // tulis mentah ke stderr lewat arbitrase statusline.ts: pesan [warn] lain
471
+ // di-commit sebagai baris permanen, dan frame spinner tak menghapus baris layar
472
+ // interaktif saat wizard setup pertama aktif (statusline.beginInteractiveScreen
473
+ // menahan paintWrite).
473
474
  const { createSpinner } = await import("../src/ui/runtime/spinner.ts")
474
475
  if (enterRepl) {
475
476
  const ctrl = new AbortController()
@@ -592,12 +593,33 @@ if (enterRepl) {
592
593
  // Satu-satunya tampilan interaktif = TUI fullscreen (REPL linier dihapus).
593
594
  // One-shot/exec tak tersentuh (cabang else di bawah).
594
595
  const { runTui } = await import("./tui.ts")
596
+ const replStart = Date.now()
595
597
  try {
596
598
  await runTui(ctx)
597
599
  } catch (error) {
598
600
  process.stderr.write(`[error] ${formatError(error)}\n`)
599
601
  process.exitCode = 1
600
602
  }
603
+ // Kop ringkasan sesi saat exit (logo + detail). HANYA untuk sesi interaktif
604
+ // nyata (stdout TTY): `--interactive` lewat pipe/paksa TUI tanpa terminal
605
+ // harus TIDAK menulis apa pun ke stdout (dicek test startup-failure).
606
+ // Clear screen + home digabung SATU write dengan summary (OAP-008: writer
607
+ // count per berkas dibatasi) — keluar alternate-screen tak selalu kembalikan
608
+ // kursor ke baris bersih (ConPTY), jadi clear mencegah tumpang-tindih teks.
609
+ if (process.stdout.isTTY) {
610
+ try {
611
+ const u = ctx.usage.getSession(ctx.modelRef.current)
612
+ const { renderSessionSummary } = await import("../src/ui/render/session-summary.ts")
613
+ const summary = renderSessionSummary({
614
+ sessionId: ctx.sessionId,
615
+ model: ctx.modelRef.current ?? "default",
616
+ totalTokens: u.totalTokens,
617
+ ...(u.cost != null ? { cost: u.cost } : {}),
618
+ durationMs: Date.now() - replStart,
619
+ })
620
+ process.stdout.write(`\x1b[2J\x1b[H${summary}`)
621
+ } catch {}
622
+ }
601
623
  } else {
602
624
  // P12 S2.2 (F-DISCUSS-4) + P0.2: one-shot linear memakai `ctx.workMode`
603
625
  // efektif (termasuk hasil pulihan `--resume`).
package/cli/router.ts CHANGED
@@ -58,6 +58,7 @@ export async function dispatch(
58
58
  for (let i = 0; i < subArgv.length; i++) {
59
59
  const a = subArgv[i]
60
60
  if (a === undefined) continue
61
+ if (a === "--") break
61
62
  if (a === name) {
62
63
  const v = subArgv[i + 1]
63
64
  if (v !== undefined && (v === "-" || !v.startsWith("-") || /^-?\d+(\.\d+)?$/.test(v)))
@@ -70,6 +71,16 @@ export async function dispatch(
70
71
  return found
71
72
  }
72
73
 
74
+ // P11.x — argv scoped untuk SEMUA handler subcommand: kecuali yang sudah
75
+ // memakai pola own-scoped (openwork/exec/daemon), handler lain mengindeks
76
+ // `args[0]`/`args[1]` sebagai token subcommand. `args` di sini adalah argv
77
+ // PENUH, jadi flag global yang mendahului subcommand (mis. `--cwd X sessions
78
+ // list` atau `--json pricing status`) membuat `args[1]` menyimpan NILAI flag,
79
+ // bukan sub-aksi — handler mencetak "unknown subcommand: <path>" atau diam
80
+ // (providers exit 0). `args.slice(cmdIndex)` menempatkan kembali token
81
+ // subcommand di indeks 0; flag global tetap terbaca lewat `subGetArg`
82
+ // (berbasis subArgv yang sudah memuat flag global + argv dari cmd).
83
+ const scoped = args.slice(cmdIndex)
73
84
  if (cmd === "stats") {
74
85
  const { handleStats } = await import("./commands/stats.ts")
75
86
  await handleStats(subGetArg)
@@ -77,44 +88,46 @@ export async function dispatch(
77
88
  }
78
89
  if (cmd === "sessions") {
79
90
  const { handleSessions } = await import("./commands/sessions.ts")
80
- await handleSessions(args, subGetArg)
91
+ await handleSessions(scoped, subGetArg)
81
92
  return true
82
93
  }
83
94
  if (cmd === "openwork") {
84
95
  // [P14.4] Portofolio open-work lintas sesi (read-only) + merge dedup
85
96
  // eksplisit (P14.3). Handler process.exit sendiri (kontrak I28).
97
+ // openwork memakai `args.indexOf("openwork")` (actionAfter), jadi ia tetap
98
+ // menerima argv penuh agar token "openwork" tetap ditemukan.
86
99
  const { handleOpenwork } = await import("./commands/openwork.ts")
87
100
  await handleOpenwork(args, subGetArg)
88
101
  return true
89
102
  }
90
103
  if (cmd === "mcp") {
91
104
  const { handleMcp } = await import("./commands/mcp.ts")
92
- await handleMcp(args, subGetArg, HELP)
105
+ await handleMcp(scoped, subGetArg, HELP)
93
106
  return true
94
107
  }
95
108
  if (cmd === "config") {
96
109
  const { handleConfig } = await import("./commands/config.ts")
97
- await handleConfig(args, subGetArg, HELP)
110
+ await handleConfig(scoped, subGetArg, HELP)
98
111
  return true
99
112
  }
100
113
  if (cmd === "skills") {
101
114
  const { handleSkills } = await import("./commands/skills.ts")
102
- await handleSkills(args, subGetArg)
115
+ await handleSkills(scoped, subGetArg)
103
116
  return true
104
117
  }
105
118
  if (cmd === "providers" || cmd === "models" || cmd === "sync") {
106
119
  const { handleProviders } = await import("./commands/providers.ts")
107
- await handleProviders(args, subGetArg)
120
+ await handleProviders(scoped, subGetArg)
108
121
  return true
109
122
  }
110
123
  if (cmd === "auth") {
111
124
  const { handleAuth } = await import("./commands/auth.ts")
112
- await handleAuth(args)
125
+ await handleAuth(scoped)
113
126
  return true
114
127
  }
115
128
  if (cmd === "pricing") {
116
129
  const { handlePricing } = await import("./commands/pricing.ts")
117
- await handlePricing(args)
130
+ await handlePricing(scoped)
118
131
  return true
119
132
  }
120
133
  if (cmd === "exec") {
@@ -150,12 +163,12 @@ export async function dispatch(
150
163
  }
151
164
  if (cmd === "memory") {
152
165
  const { handleMemory } = await import("./commands/memory.ts")
153
- await handleMemory(args, subGetArg)
166
+ await handleMemory(scoped, subGetArg)
154
167
  return true
155
168
  }
156
169
  if (cmd === "doctor") {
157
170
  const { handleDoctor } = await import("./commands/doctor.ts")
158
- await handleDoctor(args, subGetArg)
171
+ await handleDoctor(scoped, subGetArg)
159
172
  return true
160
173
  }
161
174
  return false
package/cli/setup.ts CHANGED
@@ -59,6 +59,8 @@ import {
59
59
  matchTurnBySummary,
60
60
  pendingVerificationObservation,
61
61
  projectProvenance,
62
+ provenanceMark,
63
+ verificationMark,
62
64
  } from "../src/presentation/projection.ts"
63
65
  import {
64
66
  createReducerDiagnostics,
@@ -1793,9 +1795,20 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1793
1795
  }
1794
1796
  }
1795
1797
  const compaction = createLlmCompaction({
1796
- ...(process.env.DEEPSEEK_API_KEY ? { apiKey: process.env.DEEPSEEK_API_KEY } : {}),
1797
- baseUrl: process.env.DEEPSEEK_BASE_URL ?? "https://api.deepseek.com/v1",
1798
- model: "deepseek-chat",
1798
+ // LLM compaction DIUTAMAKAN supaya fakta tak hilang lewat fallback mekanikal
1799
+ // yang lossy. Provider: summarizer murah khusus (DEEPSEEK_API_KEY) ATAU
1800
+ // pakai ulang provider sesi (router) — jangan diam-diam jatuh ke mekanikal
1801
+ // bila sesi punya provider.
1802
+ ...(process.env.DEEPSEEK_API_KEY
1803
+ ? {
1804
+ apiKey: process.env.DEEPSEEK_API_KEY,
1805
+ baseUrl: process.env.DEEPSEEK_BASE_URL ?? "https://api.deepseek.com/v1",
1806
+ model: "deepseek-chat",
1807
+ }
1808
+ : {
1809
+ provider: router,
1810
+ model: modelRef.current ?? cfg.providers[0]?.models[0] ?? "deepseek-chat",
1811
+ }),
1799
1812
  cwd: cwd ?? process.cwd(),
1800
1813
  getContextWindowTokens,
1801
1814
  onUsage: (u) => {
@@ -1810,8 +1823,8 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1810
1823
  totalTokens: u.totalTokens,
1811
1824
  source: "compaction",
1812
1825
  // P1.4: atribusi biaya compaction memakai model yang benar-benar
1813
- // dipakai (deepseek-chat), bukan model utama sesi.
1814
- model: "deepseek-chat",
1826
+ // dipakai (u.model dari compactWithLlm), bukan hardcode.
1827
+ model: u.model,
1815
1828
  },
1816
1829
  })
1817
1830
  } catch {}
@@ -3004,6 +3017,8 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
3004
3017
  describeActivity,
3005
3018
  matchTurn: matchTurnBySummary,
3006
3019
  elapsedVisible,
3020
+ verificationMark,
3021
+ provenanceMark,
3007
3022
  },
3008
3023
  })
3009
3024
  if (enterRepl === true) {
package/cli/tui.ts CHANGED
@@ -21,6 +21,8 @@ import {
21
21
  describeActivity,
22
22
  elapsedVisible,
23
23
  matchTurnBySummary,
24
+ provenanceMark,
25
+ verificationMark,
24
26
  } from "../src/presentation/projection.ts"
25
27
  import { redoLastCheckpoint, undoLastCheckpoint } from "../src/session/checkpoint.ts"
26
28
  import { renderSkill } from "../src/skills/loader.ts"
@@ -58,6 +60,7 @@ const DRIVER_COMMANDS = [
58
60
  "/thinking",
59
61
  "/expand [id]",
60
62
  "/minimize",
63
+ "/fold",
61
64
  "/mode",
62
65
  "/work-mode",
63
66
  ]
@@ -153,7 +156,8 @@ export async function runTui(ctx: CliSession): Promise<void> {
153
156
  } = ctx
154
157
  const { session } = ctx
155
158
  // [Area A · PROMPT 06] State UI sesi. `runTui` juga dijalankan fixture tes
156
- // dengan CliSession parsial — absen berarti pakai instance default.
159
+ // dengan CliSession parsial — absen berarti pakai instance default (dipakai
160
+ // tes yang memasangkan logger linier + TUI pada state yang sama).
157
161
  const ui: UiSessionState = ctx.uiState ?? defaultUiState
158
162
  const getPresentationSnapshot = () =>
159
163
  typeof ctx.getPresentationSnapshot === "function"
@@ -161,8 +165,18 @@ export async function runTui(ctx: CliSession): Promise<void> {
161
165
  : { activities: [], turns: [] }
162
166
 
163
167
  let mode: string = permissions?.getMode() ?? permissionMode ?? "auto"
168
+ // Mode permission sebelum /unrestric diaktifkan — dipakai untuk memulihkan
169
+ // saat operator menonaktifkannya kembali (toggle, per-sesi).
170
+ let modeBeforeUnrestricted: string | null = null
171
+ let workModeBeforeUnrestricted: "DISCUSS" | "PLAN" | "EXECUTE" | null = null
164
172
  if (process.env.MINICODE_COMPACT === undefined) ui.setCompactMode(true)
165
173
  if (process.env.MINICODE_MINIMIZE_TOOL === undefined) ui.setSectionMinimized("tool", true)
174
+ // Grouping aktivitas tool jadi satu baris (opencode-like): default ON di TUI;
175
+ // `MINICODE_MINIMIZE_ACTIVITY=0` eksplisit mematikan (transparan). Hanya
176
+ // disetel pada instance MILIK SESI (ctx.uiState ada) — bukan singleton default
177
+ // (dipakai path tes) agar nilai tidak bocor antar tes.
178
+ if (ctx.uiState !== undefined && process.env.MINICODE_MINIMIZE_ACTIVITY === undefined)
179
+ ui.setMinimizeActivity(true)
166
180
  let warned80 = false
167
181
  let abort: AbortController | null = null
168
182
 
@@ -184,6 +198,8 @@ export async function runTui(ctx: CliSession): Promise<void> {
184
198
  describeActivity,
185
199
  matchTurn: matchTurnBySummary,
186
200
  elapsedVisible,
201
+ verificationMark,
202
+ provenanceMark,
187
203
  },
188
204
  })
189
205
 
@@ -391,18 +407,18 @@ export async function runTui(ctx: CliSession): Promise<void> {
391
407
  * membanjiri transkrip. Detail penuh = `/help tombol` (delegasi).
392
408
  */
393
409
  function helpConcise(): void {
394
- // Diturunkan dari registry (BUILTIN + driver) — perintah baru tak bisa
395
- // hilang dari /help diam-diam (satu sumber, bukan daftar hardcode).
396
- // Set menjaga urutan deklarasi sekaligus mencegah duplikasi saat perintah
397
- // driver terdaftar di completion (DRIVER_COMMANDS) dan help (DRIVER_HELP_COMMANDS).
398
- const builtin = BUILTIN_COMMANDS.map((b) => `/${b.name}`).join(" ")
399
- const driver = [
400
- ...new Set([...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)]),
401
- ].join(" ")
410
+ // Grup kurasi (sengaja bukan dump flat dari registry): label + baris pendek
411
+ // per kategori supaya /help mudah dipindai. Daftar tetap 1:1 dengan command
412
+ // yang ditangani di `submit` (bila ada command baru, tambahkan ke grup yang
413
+ // tepat di sini). Tab completion tetap diturunkan dari registry (suggestions).
414
+ const group = (label: string, cmds: string): string => ` ${label.padEnd(9)}${cmds}`
402
415
  transcript.pushInfo([
403
416
  t("help.cHead"),
404
- ` ${builtin}`,
405
- ` ${driver}`,
417
+ group(t("help.gSession"), "/status /sessions /history /clear /copy /init /exit"),
418
+ group(t("help.gModel"), "/model /provider /sync"),
419
+ group(t("help.gMode"), "/mode /work-mode /undo /redo /lang"),
420
+ group(t("help.gView"), "/compact /thinking /expand /minimize /fold"),
421
+ group(t("help.gTask"), "/scheduler"),
406
422
  t("help.cKeys"),
407
423
  t("help.cMore"),
408
424
  ])
@@ -497,6 +513,39 @@ export async function runTui(ctx: CliSession): Promise<void> {
497
513
  workModeControl.setWorkMode(next)
498
514
  return
499
515
  }
516
+ // /unrestric — full akses tanpa gerbang (jail + bash-guard + sandbox/allowlist).
517
+ // HIDDEN dari daftar "/" dan /help: operator yang tahu perintahnya yang bisa
518
+ // memanggil. Berlaku per-sesi, toggle. Gerbang keamanan = kepercayaan operator.
519
+ if (name === "unrestric" || name === "unrestrict") {
520
+ const norm = args.trim().toLowerCase()
521
+ const next = norm === "" ? mode !== "unrestricted" : norm === "on" || norm === "1"
522
+ if (next) {
523
+ if (mode !== "unrestricted") {
524
+ modeBeforeUnrestricted = mode
525
+ workModeBeforeUnrestricted = workModeControl?.getWorkMode() ?? "DISCUSS"
526
+ }
527
+ mode = "unrestricted"
528
+ permissions?.setMode("unrestricted")
529
+ // WorkMode EXECUTE (BUILD) agar ceiling DISCUSS/PLAN tak menahan tulis.
530
+ workModeControl?.setWorkMode("EXECUTE")
531
+ app.repaint()
532
+ transcript.pushInfo([c.warning(t("tui.unrestrictedOn"))])
533
+ return
534
+ }
535
+ mode = modeBeforeUnrestricted ?? "auto"
536
+ // modeBeforeUnrestricted adalah nilai sebelum /unrestric: auto/ask (via /mode)
537
+ // atau allow-all/allowlist (via flag start). Tidak pernah readonly/plan/
538
+ // unrestricted — cast jujur ke himpunan yang memang bisa dipegang `mode`.
539
+ permissions?.setMode(mode as "auto" | "ask" | "allow-all" | "allowlist")
540
+ // Pulihkan juga WorkMode semula (DISCUSS/PLAN) agar ceiling read-only
541
+ // kembali berlaku — tanpa ini toggle-off meninggalkan BUILD (tulis bebas).
542
+ workModeControl?.setWorkMode(workModeBeforeUnrestricted ?? "DISCUSS")
543
+ modeBeforeUnrestricted = null
544
+ workModeBeforeUnrestricted = null
545
+ app.repaint()
546
+ transcript.pushInfo([c.muted(t("tui.unrestrictedOff", { m: mode }))])
547
+ return
548
+ }
500
549
  if (name === "lang") {
501
550
  const { currentLocale, setSessionLocale } = await import("../src/ui/i18n/locale.ts")
502
551
  if (!args) {
@@ -526,6 +575,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
526
575
  ui.setReasoningVisible(next)
527
576
  return
528
577
  }
578
+ if (name === "fold") {
579
+ const next = args === "" ? undefined : args === "on" || args === "1"
580
+ const on = ui.setMinimizeActivity(next)
581
+ transcript.pushInfo([c.muted(t("tui.activityFold", { v: on ? "folded" : "expanded" }))])
582
+ return
583
+ }
529
584
  if (name === "expand") {
530
585
  const sections = args ? ctx.expandContent(args) : ctx.expandAllContent()
531
586
  const views = args ? [] : ui.collapsedSectionsSnapshot()
@@ -639,9 +694,13 @@ export async function runTui(ctx: CliSession): Promise<void> {
639
694
  const status = {
640
695
  footer: {
641
696
  // Normalisasi: sumbu persetujuan hanya AUTO/ASK. Profil warisan
642
- // (allow-all/allowlist) tak lagi bocor sebagai label mode.
643
- mode: mode === "ask" ? "ask" : "auto",
644
- strictBash: permissions?.getRestrictBash?.() ?? false,
697
+ // (allow-all/allowlist) tak lagi bocor sebagai label mode. "unrestricted"
698
+ // adalah mode full-akses eksplisit (/unrestric) — tampil apa adanya.
699
+ mode: mode === "ask" ? "ask" : mode === "unrestricted" ? "unrestricted" : "auto",
700
+ // Gembok (allow-list) terang HANYA saat allow-list benar-benar menahan
701
+ // bash: restrictBash + mode AUTO. Di ASK bash diawasi prompt (bukan
702
+ // allow-list), dan di allow-all bash bebas — keduanya gembok redup.
703
+ strictBash: (permissions?.getRestrictBash?.() ?? false) && mode === "auto",
645
704
  // P12 S2.2 Slice 5 - WorkMode LIVE (bukan snapshot boot): footer
646
705
  // mencerminkan mode aktif saat frame digambar.
647
706
  workMode: workModeControl?.getWorkMode() ?? "DISCUSS",
@@ -12,7 +12,7 @@ punya owner sendiri; yang disatukan di sini hanya *hubungannya*.
12
12
 
13
13
  | Konsep | Ukuran | Owner | Sumber kebenaran | Dipakai |
14
14
  |---|---|---|---|---|
15
- | Logical context | token ESTIMASI (chars/4, sadar-gambar) | Kernel loop + `Session.contextTokens` | `estimateSessionContext` (`vendor tokens.ts`) — messages+system+tools | pressure evaluation, footer, `/status` |
15
+ | Logical context | token ESTIMASI (densitas: kode/JSON ~2.4 cpt, CJK ~1, fallback usage anchor + tokenizer exact on-demand) | Kernel loop + `Session.contextTokens` | `estimateSessionContext` (`vendor tokens.ts`) — messages+system+tools | pressure evaluation, footer, `/status` |
16
16
  | Serialized context | chars wire (JSON/base64 +overhead) | Adapter provider | `buildRequest` per adapter | dikirim, tidak diukur tersendiri |
17
17
  | Provider usage | token yang dilaporkan provider | `createUsageCollector` | event `provider:extension{kind:"usage"}` — **boleh hilang** | akumulasi turn/session, cost |
18
18
  | Economic usage | USD estimated dari harga tabel | `costFor`/`findPrice` | harga × usage; `undefined` = unknown | `--budget`, `/status` |
package/docs/SUMMARY.md CHANGED
@@ -44,7 +44,7 @@
44
44
 
45
45
  ## Internal & Arsitektur (untuk kontributor)
46
46
 
47
- * [Terminal Contract (FROZEN) — 35 invariant, v7.7](TERMINAL_CONTRACT.md)
47
+ * [Terminal Contract (FROZEN) — 35 invariant, v7.11](TERMINAL_CONTRACT.md)
48
48
  * [Output Event Model — taksonomi dan lifecycle](OUTPUT_EVENT_MODEL.md)
49
49
  * [Output Protocol Spec — stream dan machine contract](OUTPUT_PROTOCOL_SPEC.md)
50
50
  * [Output Rendering Spec — boundary renderer](OUTPUT_RENDERING_SPEC.md)
@@ -1,4 +1,18 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7.9, 2026-11-07)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.11, 2026-11-09)
2
+
3
+ Perubahan v7.11: thinking & jawaban di TUI dan renderer linear kini membungkus di
4
+ batas kata (`wrapByWidth`) — tidak memotong di tengah kata — dan baris diff ikut
5
+ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
6
+ (v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
7
+
8
+ Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
9
+ sebagai **ikon gembok** `🔒` di ujung footer (setelah Permission Mode), terang
10
+ saat aktif (mode Auto + restrictBash) dan redup saat nonaktif. Sumbu persetujuan
11
+ tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
12
+ sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
13
+ bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
14
+ terkalibrasi yang memakai estimator yang SAMA dengan guard cutoff, sehingga
15
+ footer dan guard tidak pernah menghasilkan dua angka sumber berbeda.
2
16
 
3
17
  Perubahan v7.9: input command slash tidak ditambahkan sebagai pesan transkrip;
4
18
  aksi popup provider/model/sesi dan toggle UI tidak meninggalkan riwayat status
@@ -87,7 +101,7 @@ proteksi").
87
101
  | Stream | Isi | Catatan |
88
102
  |---|---|---|
89
103
  | stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
90
- | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
104
+ | stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (default terlihat; `MINICODE_SHOW_THINKING=0` minimized), warning, error | Boleh transient rendering bila stderr TTY |
91
105
  | keduanya | Warna hanya bila stream TTY (`stdout.isTTY`); `NO_COLOR` menang; TERM/COLORTERM env TIDAK menyalakan warna pada pipe/redirect | Lihat `src/ui/render/theme.ts` `colorLevel()` |
92
106
 
93
107
  Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
@@ -188,8 +202,9 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
188
202
  - Layar tak mampu (non-TTY, `rows < 10`, `TERM=dumb`): view menolak BERSUARA
189
203
  + batal (fail-closed). TAK BOLEH diam.
190
204
  - `/status` & `/history` = readout ke transkrip (bukan popup); `/help` ringkas
191
- (≤6 baris, penuh via `/help tombol`); `/expand` membuka buffer isi tool;
192
- pilihan `/model` persist antar sesi + struk `model: x` di transkrip.
205
+ (terkelompok ≤8 baris, penuh via `/help full`, pintasan via `/help keys`);
206
+ `/expand` membuka buffer isi tool; pilihan `/model` persist antar sesi +
207
+ struk `model: x` di transkrip.
193
208
 
194
209
  ## Invariant (nomor dipakai di peta proteksi)
195
210
 
@@ -218,6 +233,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
218
233
 
219
234
  13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
220
235
  context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
236
+ Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
237
+ bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
221
238
  Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
222
239
  konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
223
240
  atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
@@ -292,9 +309,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
292
309
  di footer form ("batal dalam 10 dtk" — bukan countdown hidup), 10 dtk
293
310
  berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
294
311
  ketikan apa pun me-reset kedua timer.
295
- 22. Thinking terlihat: composer memakai dots clock; transkrip minimized =
296
- bersih tanpa marker (`… thinking`), expanded = alir redup; isi tetap
297
- tersedia di `/expand`; fase berakhir = commit (tak ada thinking yatim).
312
+ 22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
313
+ transkrip expanded = alir thinking ber-warna terbaca (`c.thinking`,
314
+ abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
315
+ jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
316
+ = bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
317
+ fase berakhir = commit (tak ada thinking yatim).
298
318
  23. Approval & ask_user tercatat di transkrip (pertanyaan + keputusan) dan
299
319
  terlihat sebelum menjawab; non-TTY = deny/null fail-closed; stdout
300
320
  di-pipe tanpa sink TUI = deny/null (prompt tak terlihat + mencemari
@@ -303,7 +323,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
303
323
  dengan id membaca satu tool, tanpa id membaca seluruh entry store yang
304
324
  masih hidup; miss → durable sqlite → penanda retensi. Pilihan `/model`
305
325
  persist antar sesi + struk `model: x`; `/help` ringkas (penuh via
306
- `/help tombol`).
326
+ `/help full`, pintasan via `/help keys`).
307
327
  25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
308
328
  backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
309
329
  (`↑↓`, pgup/pgdn, home/end) di semua popup; hint footer akurat
@@ -434,19 +454,24 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
434
454
 
435
455
  prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
436
456
  berbingkai di atasnya) ·
437
- status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`
457
+ status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto 🔒`
438
458
  (timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
439
459
  jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
440
- dipadatkan pada terminal sempit)
460
+ dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
441
461
  + satu spacer sebelum footer · ledger tool
442
462
  ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
443
463
  kegagalan · pesan error TUI = formatter kanonik (`formatError`,
444
464
  `src/ui/render/errors.ts`): credential di-redaksi (bearer/key/query), escape
445
465
  ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
446
- pernah tampil · thinking: dots clock / alir redup · popup: konten redup di
466
+ pernah tampil · thinking: dots clock / alir thinking terbaca · popup: konten redup di
447
467
  belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
448
468
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
449
469
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
470
+ `/fold` = lipat aktivitas tool per turn (`MINICODE_MINIMIZE_ACTIVITY`, ON di TUI) —
471
+ baris ledger per-tool dirangkum jadi SATU baris ringkas (`✓ n tools · nama · x ok · y gagal`),
472
+ tidak hilang diam-diam; detail dibuka via `/expand` ·
473
+ tabel markdown dirender kotak ber-garis (opencode-like) ber-`wrap` (konten panjang
474
+ tidak kepotong) + margin kiri 1 kolom; teks paragraf ber-margin kiri 1 kolom ·
450
475
  Projection V2: `› name target … running`, ledger status ber-glyph/kata,
451
476
  retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
452
477
  identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
@@ -552,7 +577,7 @@ panjang).
552
577
  Esc-1 kembalikan prefill, Esc-2 batal).
553
578
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
554
579
  stdout-pipe tanpa sink = deny).
555
- - `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit).
580
+ - `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, ikon gembok 🔒 terang/redup).
556
581
  - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
557
582
  dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
558
583
  yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti