minicode-ai 0.20.0 → 0.22.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 (58) hide show
  1. package/README.md +1 -1
  2. package/cli/auto-update.ts +24 -15
  3. package/cli/commands/exec.ts +44 -1
  4. package/cli/commands.ts +5 -2
  5. package/cli/index.ts +57 -18
  6. package/cli/setup.ts +88 -34
  7. package/cli/tui.ts +22 -2
  8. package/docs/TERMINAL_CONTRACT.md +50 -11
  9. package/docs/UI_RENDER_PIPELINE.md +6 -3
  10. package/docs/architecture.md +10 -6
  11. package/docs/concepts.md +1 -1
  12. package/docs/contributing.md +4 -3
  13. package/docs/environment.md +2 -0
  14. package/docs/policy-sandbox.md +6 -1
  15. package/docs/security.md +12 -4
  16. package/docs/skills.md +1 -1
  17. package/package.json +2 -2
  18. package/src/config.ts +8 -6
  19. package/src/daemon/discovery.ts +24 -0
  20. package/src/policy/bash-guard.ts +170 -6
  21. package/src/policy/compaction.ts +34 -7
  22. package/src/policy/jail.ts +10 -22
  23. package/src/policy/permission.ts +9 -6
  24. package/src/policy/update-check.ts +6 -4
  25. package/src/presentation/projection.ts +1 -1
  26. package/src/providers/anthropic.ts +14 -4
  27. package/src/providers/responses.ts +1 -1
  28. package/src/providers/sse-bounds.ts +16 -2
  29. package/src/ui/approval/prompt.ts +17 -6
  30. package/src/ui/assistant/simple.ts +14 -0
  31. package/src/ui/footer.ts +2 -2
  32. package/src/ui/i18n/en.ts +29 -1
  33. package/src/ui/i18n/id.ts +29 -1
  34. package/src/ui/input/prompt-engine.ts +6 -0
  35. package/src/ui/render/activity-group.ts +53 -0
  36. package/src/ui/render/activity-panel.ts +91 -0
  37. package/src/ui/render/cells.ts +33 -6
  38. package/src/ui/render/diff.ts +58 -2
  39. package/src/ui/render/highlight.ts +68 -37
  40. package/src/ui/render/markdown.ts +6 -1
  41. package/src/ui/render/sanitize.ts +5 -1
  42. package/src/ui/render/session-summary.ts +11 -4
  43. package/src/ui/render/table-grid.ts +123 -13
  44. package/src/ui/render/table.ts +4 -2
  45. package/src/ui/render/theme.ts +19 -3
  46. package/src/ui/render/width.ts +35 -6
  47. package/src/ui/render/wrap.ts +28 -6
  48. package/src/ui/runtime/loading-bar.ts +137 -0
  49. package/src/ui/screens/dialog.ts +23 -2
  50. package/src/ui/screens/form.ts +52 -10
  51. package/src/ui/screens/model-manager.ts +8 -2
  52. package/src/ui/screens/picker.ts +11 -3
  53. package/src/ui/screens/provider-manager.ts +11 -3
  54. package/src/ui/screens/wizard.ts +29 -1
  55. package/src/ui/session-state.ts +22 -0
  56. package/src/ui/tui/app.ts +57 -20
  57. package/src/ui/tui/transcript.ts +204 -27
  58. package/vendor/minicore/src/providers/openai-compat.ts +30 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # MiniCode
2
2
 
3
- MiniCode is an open-source terminal coding agent built on the frozen MiniCore kernel. It is zero-dependency (Bun is the only runtime). It inspects and edits a workspace, runs local tools, and connects to the AI providers and MCP/LSP servers you configure.
3
+ MiniCode is an open-source terminal coding agent built on the vendored MiniCore kernel (host-editable since v0.16.0). It is zero-dependency (Bun is the only runtime). It inspects and edits a workspace, runs local tools, and connects to the AI providers and MCP/LSP servers you configure.
4
4
 
5
5
  Interactive sessions run as a fullscreen TUI; one-shot and automation runs flow to the shell scrollback or a machine-readable JSONL stream. Every tool action is visible in the ledger, file changes are jailed to the workspace, and sensitive actions are gated behind your permission. Prompts and relevant workspace context are sent to the provider you configure; MCP and LSP servers may receive data or perform external effects. MiniCode itself sends no telemetry — traces are local-only (`MINICODE_TELEMETRY=0` to disable).
6
6
 
@@ -45,7 +45,14 @@ export function waitChildExit(child: ChildProcess): Promise<number | null> {
45
45
  export async function maybeAutoUpdate(
46
46
  version: string,
47
47
  signal?: AbortSignal,
48
- opts?: { onLongOp?: () => void; getInstalledVersion?: () => string },
48
+ opts?: {
49
+ onLongOp?: () => void
50
+ getInstalledVersion?: () => string
51
+ /** Fase progres untuk bar loading: "check" | "install" | "restart". */
52
+ onPhase?: (phase: "check" | "install" | "restart") => void
53
+ /** Sink pesan proses (deferred ke transcript saat bar aktif). */
54
+ onNotice?: (line: string) => void
55
+ },
49
56
  ): Promise<void> {
50
57
  let decision: ReturnType<typeof shouldAutoUpdate>
51
58
  try {
@@ -58,6 +65,7 @@ export async function maybeAutoUpdate(
58
65
  }
59
66
  if (!decision.run) return
60
67
  if (signal?.aborted) return
68
+ opts?.onPhase?.("check")
61
69
  let latest: string | null
62
70
  try {
63
71
  latest = await checkForUpdateFresh(version, signal)
@@ -66,16 +74,16 @@ export async function maybeAutoUpdate(
66
74
  }
67
75
  if (signal?.aborted) return
68
76
  if (!latest) return
69
- // Fase panjang dimulai (install + restart): minta pemanggil mematikan
70
- // spinner transient-nya DULU. Tanpa ini interval induk (80ms di
71
- // cli/index.ts) terus menulis `\r\x1b[2K` ke stderr yang sama dengan anak
72
- // (`stdio: inherit`) selama SELURUH sesi anak — output hancur/flicker dan
73
- // terlihat hang di Windows Terminal.
77
+ // Fase panjang dimulai (install + restart): minta pemanggil menghentikan
78
+ // bar transient-nya DULU. Output anak (npm/respawn) kini dipipe dan
79
+ // disembunyikan (stdio: "pipe") sehingga tidak mengotori bar — pewarisan
80
+ // `inherit` lama membuat output npm mentah menimpa spinner/bar.
74
81
  try {
75
82
  opts?.onLongOp?.()
76
83
  } catch {}
77
- process.stderr.write(`\n${c.yellow(formatUpdateMessage(version, latest))}\n`)
78
- process.stderr.write(c.dim("Menginstall pembaruan otomatis…\n"))
84
+ opts?.onPhase?.("install")
85
+ opts?.onNotice?.(`${c.yellow(formatUpdateMessage(version, latest))}\n`)
86
+ opts?.onNotice?.(c.dim("Menginstall pembaruan otomatis…\n"))
79
87
  let ok = false
80
88
  try {
81
89
  ok = installUpdate(latest)
@@ -83,7 +91,7 @@ export async function maybeAutoUpdate(
83
91
  ok = false
84
92
  }
85
93
  if (!ok) {
86
- process.stderr.write(
94
+ opts?.onNotice?.(
87
95
  c.yellow(
88
96
  `Auto-update gagal — lanjut versi ${version}. Update manual: npm update -g minicode-ai\n`,
89
97
  ),
@@ -95,7 +103,7 @@ export async function maybeAutoUpdate(
95
103
  return verifyInstalledVersion(expected, opts.getInstalledVersion)
96
104
  }
97
105
  if (!installedMatches(latest)) {
98
- process.stderr.write(
106
+ opts?.onNotice?.(
99
107
  c.yellow(
100
108
  `Versi terpasang tidak cocok dengan target ${latest}; mencoba memulihkan ${version}…\n`,
101
109
  ),
@@ -107,11 +115,11 @@ export async function maybeAutoUpdate(
107
115
  restored = false
108
116
  }
109
117
  if (restored) {
110
- process.stderr.write(
111
- c.yellow(`Auto-update dibatalkan; versi ${version} berhasil dipulihkan.\n`),
112
- )
118
+ opts?.onNotice?.(c.yellow(`Auto-update dibatalkan; versi ${version} berhasil dipulihkan.\n`))
113
119
  return
114
120
  }
121
+ // Gagal tidak dapat dipulihkan: fatal — tetap cetak + keluar (tidak
122
+ // didefer; proses akan mati).
115
123
  process.stderr.write(
116
124
  c.error(
117
125
  `Auto-update tidak dapat memverifikasi atau memulihkan instalasi. Keluar; pulihkan dengan: npm install -g minicode-ai@${version}\n`,
@@ -121,8 +129,9 @@ export async function maybeAutoUpdate(
121
129
  }
122
130
  // Restart ke kode baru dengan argv identik; guard env cegah loop bila
123
131
  // versi ter-install ternyata masih dilaporkan lebih tua.
124
- process.stderr.write(c.dim(`Restart ke versi ${latest}…\n`))
125
- // Pastikan spinner induk mati sebelum anak hidup (idempoten — onLongOp
132
+ opts?.onPhase?.("restart")
133
+ opts?.onNotice?.(c.dim(`Restart ke versi ${latest}…\n`))
134
+ // Pastikan bar induk mati sebelum anak hidup (idempoten — onLongOp
126
135
  // sudah dipanggil sebelum install, tapi install bisa gagal-skip jalur ini
127
136
  // bila dipanggil ulang di masa depan).
128
137
  try {
@@ -34,6 +34,14 @@ function writeMachineLine(line: string): void {
34
34
  process.stdout.write(`${cleanUntrusted(scrubSecrets(line), false)}\n`)
35
35
  }
36
36
 
37
+ /** Prompt lanjutan (Phase D auto-continue): minta model menyelesaikan sisa
38
+ * pekerjaan dari titik berhenti, memanfaatkan progres parsial yang sudah
39
+ * durable (safeTurnBoundary + persist). */
40
+ const CONTINUE_PROMPT =
41
+ "Continue from where you left off: an earlier turn hit the tool-step limit " +
42
+ "but its completed steps are preserved. Finish the remaining work now " +
43
+ "(re-read state if needed) and do not start over from scratch."
44
+
37
45
  function machineSummary(ok: boolean, fields: Record<string, unknown>): Record<string, unknown> {
38
46
  return { schema: MACHINE_SCHEMA, type: "summary", ok, ...fields }
39
47
  }
@@ -186,6 +194,18 @@ export async function handleExec(
186
194
  )
187
195
  timeoutMs = 900_000
188
196
  }
197
+ // Phase D — auto-continue (opt-in): pecah tugas panjang menjadi beberapa turn
198
+ // bounded. Saat turn berakhir dengan max_steps_exceeded, kernel SUDAH
199
+ // meng-commit progres parsial (safeTurnBoundary); run lanjutan melanjutkan dari
200
+ // situ alih-alih mati fatal. `--max-turns` menetapkan jumlah turn lanjutan
201
+ // (default 3) — hard cap mencegah loop belanja; --budget tetap mengikat per turn.
202
+ const autoContinue =
203
+ hasFlag(subArgs, "--auto-continue") || process.env.MINICODE_AUTO_CONTINUE === "1"
204
+ const maxTurnsRaw = getArg("--max-turns")
205
+ const autoContinueBudget =
206
+ maxTurnsRaw && Number.isFinite(Number(maxTurnsRaw)) && Number(maxTurnsRaw) > 0
207
+ ? Math.min(20, Math.floor(Number(maxTurnsRaw)))
208
+ : 3
189
209
 
190
210
  const ignoredFlags = flagsAfterPromptBoundary(subArgs)
191
211
  if (ignoredFlags.length > 0) {
@@ -296,7 +316,30 @@ export async function handleExec(
296
316
  )
297
317
  })
298
318
  try {
299
- await ctx.runPromptWithVerify(effectivePrompt)
319
+ if (autoContinue) {
320
+ // Lanjutkan sampai selesai / cap tercapai. `isStepLimit` memisahkan
321
+ // "habis langkah" (layak dilanjut) dari error lain (auth/network/dll yang
322
+ // wajib gagal keras). Tiap iterasi = satu turn utuh pada sesi sama; kernel
323
+ // sudah commit progres parsial turn yang gagal (safeTurnBoundary).
324
+ const isStepLimit = (e: unknown): boolean =>
325
+ (e as { kind?: string } | undefined)?.kind === "max_steps_exceeded" ||
326
+ /max.?steps/i.test(String((e as { message?: string } | undefined)?.message ?? ""))
327
+ for (let i = 0; i <= autoContinueBudget; i++) {
328
+ let err: unknown = null
329
+ try {
330
+ await ctx.runPromptWithVerify(i === 0 ? effectivePrompt : CONTINUE_PROMPT)
331
+ } catch (e) {
332
+ err = e
333
+ }
334
+ if (err === null) break
335
+ if (!isStepLimit(err) || i >= autoContinueBudget) throw err
336
+ process.stderr.write(
337
+ `[auto-continue] batas langkah tercapai — melanjutkan (turn lanjutan ${i + 1}/${autoContinueBudget})\n`,
338
+ )
339
+ }
340
+ } else {
341
+ await ctx.runPromptWithVerify(effectivePrompt)
342
+ }
300
343
  // Harness-P1: exec sebelumnya mengabaikan --budget total (flag diteruskan
301
344
  // tapi tak pernah diperiksa). Samakan dengan one-shot: over → exit 1.
302
345
  const ue = ctx.usage.getSession(ctx.modelRef.current)
package/cli/commands.ts CHANGED
@@ -12,6 +12,7 @@ import {
12
12
  } from "../src/task/scheduler-observability.ts"
13
13
  import { type MsgKey, t } from "../src/ui/i18n/locale.ts"
14
14
  import { formatUsd } from "../src/ui/render/money.ts"
15
+ import { sanitizeAnsiLine } from "../src/ui/render/sanitize.ts"
15
16
  import { glyphs } from "../src/ui/render/theme.ts"
16
17
  import { padToWidth } from "../src/ui/render/width.ts"
17
18
 
@@ -594,11 +595,13 @@ export async function handleBuiltinCommand(
594
595
  if (cfg.providers.length === 0) console.log(t("cmd.noProviders"))
595
596
  else console.log(t("cmd.noChanges"))
596
597
  } else {
598
+ // id provider datang dari probe jaringan (tak-terpercaya): paritas
599
+ // dengan `minicode providers sync` yang sudah menyaring ANSI.
597
600
  for (const r of updated) {
598
- console.log(` ${glyphs.check} ${r.id}: ${r.from} → ${r.to}`)
601
+ console.log(` ${glyphs.check} ${sanitizeAnsiLine(r.id)}: ${r.from} → ${r.to}`)
599
602
  }
600
603
  for (const f of failed) {
601
- console.log(` ${glyphs.cross} ${f.id}: ${f.reason}`)
604
+ console.log(` ${glyphs.cross} ${sanitizeAnsiLine(f.id)}: ${sanitizeAnsiLine(f.reason)}`)
602
605
  }
603
606
  // "Restart" hanya jujur bila ADA model baru — tanpa updated, restart
604
607
  // tak mengubah apa pun (sebelumnya selalu dicetak, menyesatkan saat
package/cli/index.ts CHANGED
@@ -19,8 +19,10 @@ import { GATE_ENABLED, resolveSchedulerGate } from "../src/task/production-sched
19
19
  import { writeTrace } from "../src/telemetry/trace.ts"
20
20
  import { setSubAgentSessionFactory } from "../src/tools/task.ts"
21
21
  import { formatError } from "../src/ui/assistant/simple.ts"
22
+ import { type MsgKey, t } from "../src/ui/i18n/locale.ts"
22
23
  import { formatUsd } from "../src/ui/render/money.ts"
23
24
  import { c, glyphs } from "../src/ui/render/theme.ts"
25
+ import { motionReduced } from "../src/ui/runtime/motion.ts"
24
26
  import {
25
27
  allowLocalConfig,
26
28
  displayWorkMode,
@@ -471,26 +473,38 @@ const enterRepl = interactive || (!prompt && process.stdin.isTTY)
471
473
  // di-commit sebagai baris permanen, dan frame spinner tak menghapus baris layar
472
474
  // interaktif saat wizard setup pertama aktif (statusline.beginInteractiveScreen
473
475
  // menahan paintWrite).
474
- const { createSpinner } = await import("../src/ui/runtime/spinner.ts")
476
+ const { createLoadingBar } = await import("../src/ui/runtime/loading-bar.ts")
477
+ type LoadingBar = NonNullable<ReturnType<typeof createLoadingBar>>
478
+ let startupBar: LoadingBar | null = null
475
479
  if (enterRepl) {
480
+ startupBar = createLoadingBar("", { delayMs: 120 })
476
481
  const ctrl = new AbortController()
477
482
  const to = setTimeout(() => ctrl.abort(), 1800)
478
- // Delay 120ms: cek update sering selesai <200ms — tanpa delay, spinner
479
- // berkedip lalu hilang. Pola frame 80ms sesuai kontrak startup.
480
- const spin = createSpinner("Checking for updates…", { delayMs: 120, intervalMs: 80 })
483
+ // Fase update: 0–12% (cek) → 35% (install) → 95% (restart). Tidak pernah
484
+ // menembus target fase — 100% hanya ketika REPL benar-benar siap.
481
485
  try {
482
486
  const { maybeAutoUpdate } = await import("./auto-update.ts")
483
- // Dipanggil auto-update SEBELUM fase panjang (install npm + respawn anak):
484
- // matikan spinner agar tak menulis ke stderr yang sama dengan anak selama
485
- // berjam-jam (stdio inherit) — itu yang terlihat sebagai hang/flicker.
486
- // Idempoten: aman dipanggil dua kali (sebelum install, sebelum restart).
487
487
  await maybeAutoUpdate(readVersion(), ctrl.signal, {
488
- onLongOp: () => spin.stop(),
488
+ onLongOp: () => startupBar?.stop(),
489
489
  getInstalledVersion: readVersion,
490
+ onPhase: (phase) => {
491
+ if (phase === "check") startupBar?.update(t("loading.checking"), 6)
492
+ else if (phase === "install") startupBar?.update(t("loading.installing"), 35)
493
+ else if (phase === "restart") startupBar?.update(t("loading.restarting"), 95)
494
+ },
495
+ onNotice: (line) => {
496
+ // Bar sedang dihentikan selama install/restart — pesan proses tetap
497
+ // dikirim ke stderr (append-only, tersembunyi di balik bar).
498
+ process.stderr.write(line)
499
+ },
490
500
  })
491
501
  } catch {}
492
502
  clearTimeout(to)
493
- spin.stop()
503
+ // Jalur tanpa update (kasus paling umum): hentikan bar update agar tidak
504
+ // bertabrakan dengan bar setup di bawah (satu painter transient pada satu
505
+ // waktu — kind sama, tanpa warning, tapi dua klaim hidup bersamaan).
506
+ startupBar?.stop()
507
+ startupBar = null
494
508
  }
495
509
  if (!prompt && !enterRepl) {
496
510
  process.stderr.write('usage: minicode "prompt" | minicode (interactive mode)\n')
@@ -516,18 +530,27 @@ try {
516
530
 
517
531
  // -- build session --
518
532
  // Session setup (provider/RAG/MCP/session) bisa makan detik (network + spawn)
519
- // TANPA output — user melihat kursor mati. Spinner transient TTY-only selama
520
- // setup, dibersihkan sebelum banner REPL agar tak ada jejak.
521
- // Spinner ini berjalan di atas createCliSession — termasuk saat wizard setup
522
- // pertama (picker gateway + prompt API key) memegang terminal. Lewat
523
- // createSpinner, tick-nya otomatis BERHENTI selama layar interaktif aktif
533
+ // TANPA output — user melihat kursor mati. Bar loading transient TTY-only
534
+ // selama setup, dibersihkan sebelum TUI agar tak ada jejak.
535
+ // Bar berjalan di atas createCliSession — termasuk saat wizard setup pertama
536
+ // (picker gateway + prompt API key) memegang terminal. Lewat paintWrite,
537
+ // lukisannya otomatis BERHENTI selama layar interaktif aktif
524
538
  // (statusline.beginInteractiveScreen di openAltScreen): dulu tulis mentah
525
539
  // `\r\x1b[2K` menghapus baris prompt wizard, sehingga user baru hanya melihat
526
540
  // "Menyiapkan sesi…" tanpa cara menyelesaikan setup (laporan: minicode dari
527
541
  // home selalu macet).
528
- const setupSpin = enterRepl ? createSpinner("Menyiapkan sesi…") : undefined
542
+ let setupBar: LoadingBar | null = null
543
+ const setupBarPhases: Record<string, { pct: number; label: MsgKey }> = {
544
+ "provider-layer": { pct: 55, label: "loading.provider" },
545
+ "rag-layer": { pct: 75, label: "loading.rag" },
546
+ "tool-layer": { pct: 90, label: "loading.session" },
547
+ "kernel-session": { pct: 98, label: "loading.session" },
548
+ }
549
+ if (enterRepl) {
550
+ setupBar = createLoadingBar(t("loading.session"), { delayMs: 120 })
551
+ }
529
552
  // finally: createCliSession yang melempar (provider/MCP gagal) tak boleh
530
- // membocorkan interval — tanpa ini spinner menulis ke stderr selamanya dan
553
+ // membocorkan painter — tanpa ini bar menulis ke stderr selamanya dan
531
554
  // proses tak pernah exit (terlihat hang).
532
555
  let ctx: Awaited<ReturnType<typeof createCliSession>>
533
556
  try {
@@ -565,6 +588,11 @@ try {
565
588
  timeoutMs,
566
589
  rateLimiter,
567
590
  sandboxNotice: requestedSandbox ? sandbox.notice : undefined,
591
+ onPhase: (name) => {
592
+ if (!enterRepl) return
593
+ const phase = setupBarPhases[name]
594
+ if (phase !== undefined) setupBar?.update(t(phase.label), phase.pct)
595
+ },
568
596
  })
569
597
  } catch (e) {
570
598
  // Tanpa provider = setup gagal sebelum sesi ada. Pesan + exit(1) sama
@@ -586,12 +614,23 @@ try {
586
614
  }
587
615
  throw e
588
616
  } finally {
589
- setupSpin?.stop()
617
+ setupBar?.stop()
590
618
  }
591
619
 
592
620
  if (enterRepl) {
593
621
  // Satu-satunya tampilan interaktif = TUI fullscreen (REPL linier dihapus).
594
622
  // One-shot/exec tak tersentuh (cabang else di bawah).
623
+ if (setupBar) {
624
+ setupBar.update(t("loading.finalize"), 100)
625
+ // Beri jeda satu frame agar cap 100% benar-benar terlihat sebelum baris
626
+ // dibersihkan; tanpa ini update+stop di tick yang sama membuat bar tak
627
+ // pernah tampak mencapai 100%. Dilewati pada non-TTY/motion-reduced.
628
+ if (process.stderr.isTTY && !motionReduced()) {
629
+ await new Promise((r) => setTimeout(r, 80))
630
+ }
631
+ setupBar.stop()
632
+ setupBar = null
633
+ }
595
634
  const { runTui } = await import("./tui.ts")
596
635
  const replStart = Date.now()
597
636
  try {