minicode-ai 0.20.0 → 0.21.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.
@@ -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 {
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 {
package/cli/setup.ts CHANGED
@@ -369,6 +369,12 @@ export interface CliSessionOptions {
369
369
  * prefiks prompt. Dicetak di sini (setelah provider layer lolos) supaya
370
370
  * invokasi yang mati sebelumnya tetap senyap. */
371
371
  sandboxNotice?: string
372
+ /**
373
+ * Hook fase startup (bar loading). Dipanggil saat fase panjang mulai:
374
+ * "provider-layer", "rag-layer", "tool-layer", "kernel-session", "resume".
375
+ * Optional — absen = tanpa progres (perilaku lama).
376
+ */
377
+ onPhase?: (phase: string) => void
372
378
  }
373
379
 
374
380
  export interface CliSession {
@@ -515,6 +521,12 @@ export interface CliSession {
515
521
  * membaca ulang pesan stderr.
516
522
  */
517
523
  adoption: AdoptionResult | null
524
+ /**
525
+ * Baris diagnostik startup yang didefer (hanya terisi saat enterRepl —
526
+ * bar loading menggantikan teks proses). Di-flush ke transcript TUI oleh
527
+ * cli/tui.ts. Absen/undefined = tidak ada deferral (perilaku lama).
528
+ */
529
+ startupNotices?: string[]
518
530
  }
519
531
 
520
532
  function mapPresentationEvent(event: DomainEvent): UiPresentationEvent | null {
@@ -910,6 +922,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
910
922
  timeoutMs,
911
923
  rateLimiter,
912
924
  sandboxNotice,
925
+ onPhase,
913
926
  } = opts
914
927
  // [Area A · PROMPT 06] State UI milik SESI ini. Dibuat SEKALI per sesi dan
915
928
  // dipakai bersama oleh TUI (Transcript) + printer linier sesi yang sama.
@@ -917,6 +930,25 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
917
930
  // sendiri sehingga tak saling menimpa collapse/compact/reasoning.
918
931
  const uiState = new UiSessionState()
919
932
  const modelRef = { current: modelOverride }
933
+ // Collector diagnostik startup. Saat REPL + stderr TTY, bar loading
934
+ // menggantikan teks proses verbose — baris diagnostik (resume/recovery/
935
+ // context/dll) DITUNDA dan di-flush ke transcript TUI setelah sesi siap
936
+ // (lihat cli/tui.ts). Non-interaktif ATAU non-TTY (pipe/CI) tetap
937
+ // mencetak langsung seperti sebelumnya — tidak ada diagnostik yang bisa
938
+ // hilang di jalur yang tak punya transcript.
939
+ const deferStartup = enterRepl && process.stderr.isTTY === true
940
+ const startupNotices: string[] = []
941
+ const startupWrite = (s: string): void => {
942
+ if (deferStartup) startupNotices.push(s)
943
+ else process.stderr.write(s)
944
+ }
945
+ // `console.error` dipertahankan pada jalur non-interaktif (spy test
946
+ // menangkap baris provenance resume lewat console.error), tapi didefer
947
+ // saat REPL agar bar loading tetap satu-baris.
948
+ const startupConsoleError = (s: string): void => {
949
+ if (deferStartup) startupNotices.push(s)
950
+ else console.error(s)
951
+ }
920
952
  // P2.1 — SATU-SATUNYA keputusan identitas sesi. Sesudah baris ini,
921
953
  // `sessionId` adalah identitas kanonik durable; id volatil hanya `bootId`
922
954
  // (diagnostik). Tak ada jalur persistensi khusus alias: semua turunan
@@ -931,7 +963,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
931
963
  })
932
964
  const sessionId = identity.sid
933
965
  const bootId = identity.bootId
934
- process.stderr.write(`${c.dim(formatSessionIdentityLine(identity))}\n`)
966
+ startupWrite(`${c.dim(formatSessionIdentityLine(identity))}\n`)
935
967
 
936
968
  // P2.2 — admission penulis tunggal. Lease = admission; pagar mutasi =
937
969
  // writer_epoch (CAS di transaksi tulis). Komposisi ini MEMEGANG lease
@@ -948,12 +980,12 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
948
980
  if (!writerStale) {
949
981
  writerStale = true
950
982
  writerStaleNote = note
951
- process.stderr.write(
983
+ startupWrite(
952
984
  `${c.yellow(`[writer] STALE sid=${sessionId} boot=${bootId} epoch=${expectedEpoch}: ${note} — history NOT durable; resume/restart to re-acquire\n`)}`,
953
985
  )
954
986
  }
955
987
  }
956
- process.stderr.write(
988
+ startupWrite(
957
989
  `${c.dim(`[writer] admitted sid=${sessionId} boot=${bootId} epoch=${expectedEpoch}${admission.admission.tookOver ? " (takeover)" : ""}${admission.admission.fresh ? " (fresh)" : ""}\n`)}`,
958
990
  )
959
991
  // [P14] Adopsi eksplisit berjalan SETELAH admission target (token target
@@ -975,7 +1007,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
975
1007
  throw new AdoptionRefusedError(adoption)
976
1008
  }
977
1009
  const moved = adoption.task
978
- process.stderr.write(
1010
+ startupWrite(
979
1011
  `${c.dim(`[adopt] ADOPTED ${adoptTask.taskId} ${adoptTask.sourceSessionId} -> ${sessionId} revision=${moved?.revision ?? "?"} status=${moved?.status ?? "?"} exec=${adoption.transfer?.execGeneration ?? "?"}${adoption.fencedFormerOwner ? " (former owner fenced)" : ""}\n`)}`,
980
1012
  )
981
1013
  }
@@ -988,9 +1020,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
988
1020
  const planAsWorkMode =
989
1021
  plan && !workModeExplicit && workMode === "DISCUSS" ? ("PLAN" as const) : workMode
990
1022
  if (plan && !workModeExplicit && workMode === "DISCUSS") {
991
- process.stderr.write(
992
- `${c.dim("[deprecated] --plan is now WorkMode PLAN; use --work-mode PLAN\n")}`,
993
- )
1023
+ startupWrite(`${c.dim("[deprecated] --plan is now WorkMode PLAN; use --work-mode PLAN\n")}`)
994
1024
  }
995
1025
  const effectiveWorkMode: "DISCUSS" | "PLAN" | "EXECUTE" =
996
1026
  identity.resumed && !workModeExplicit && !plan
@@ -1013,7 +1043,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1013
1043
  try {
1014
1044
  const orphans = tombstoneOrphanChildRuns(sessionId, cwd, { expectedEpoch })
1015
1045
  if (orphans.length > 0) {
1016
- process.stderr.write(
1046
+ startupWrite(
1017
1047
  `${c.yellow(`[child] ${orphans.length} orphaned sub-agent run(s) tombstoned (INTERRUPTED/UNKNOWN)\n`)}`,
1018
1048
  )
1019
1049
  }
@@ -1028,7 +1058,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1028
1058
  const out = renewSessionWriter(sessionId, writerToken, cwd)
1029
1059
  if (out === "AUTHORITY_LOST" && !renewWarned) {
1030
1060
  renewWarned = true
1031
- process.stderr.write(
1061
+ startupWrite(
1032
1062
  `${c.yellow(`[writer] lease lost sid=${sessionId} boot=${bootId} — another writer took over; next mutation will be refused unless re-acquired\n`)}`,
1033
1063
  )
1034
1064
  try {
@@ -1052,7 +1082,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1052
1082
  const re = acquireSessionWriter({ sessionId, cwd, bootId, token: writerToken })
1053
1083
  if (re.ok) {
1054
1084
  if (re.admission.epoch !== expectedEpoch) {
1055
- process.stderr.write(
1085
+ startupWrite(
1056
1086
  `${c.dim(`[writer] re-acquired sid=${sessionId} boot=${bootId} epoch=${re.admission.epoch}\n`)}`,
1057
1087
  )
1058
1088
  }
@@ -1110,11 +1140,12 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1110
1140
  // fase session-setup ke stderr (`[startup] rag 8432ms`). Tanpa env = diam.
1111
1141
  const startupPhase = async <T>(name: string, fn: () => Promise<T>): Promise<T> => {
1112
1142
  const s = Date.now()
1143
+ onPhase?.(name)
1113
1144
  try {
1114
1145
  return await fn()
1115
1146
  } finally {
1116
1147
  if (process.env.MINICODE_DEBUG_STARTUP === "1")
1117
- process.stderr.write(`[startup] ${name} ${Date.now() - s}ms\n`)
1148
+ startupWrite(`[startup] ${name} ${Date.now() - s}ms\n`)
1118
1149
  }
1119
1150
  }
1120
1151
 
@@ -1125,12 +1156,10 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1125
1156
  let effectiveTimeoutMs =
1126
1157
  timeoutMs ?? (envTimeout != null && envTimeout !== "" ? Number(envTimeout) : 3_600_000)
1127
1158
  if (!Number.isFinite(effectiveTimeoutMs) || effectiveTimeoutMs < 0) {
1128
- process.stderr.write(`[warn] invalid timeout ${effectiveTimeoutMs}, fallback to 3600000\n`)
1159
+ startupWrite(`[warn] invalid timeout ${effectiveTimeoutMs}, fallback to 3600000\n`)
1129
1160
  effectiveTimeoutMs = 3_600_000
1130
1161
  } else if (effectiveTimeoutMs > LIMITS.MAX_TIMER_DELAY_MS) {
1131
- process.stderr.write(
1132
- `[warn] timeout exceeds runtime limit; capped at ${LIMITS.MAX_TIMER_DELAY_MS}ms\n`,
1133
- )
1162
+ startupWrite(`[warn] timeout exceeds runtime limit; capped at ${LIMITS.MAX_TIMER_DELAY_MS}ms\n`)
1134
1163
  effectiveTimeoutMs = LIMITS.MAX_TIMER_DELAY_MS
1135
1164
  }
1136
1165
  // `--timeout` adalah deadline satu pemanggilan prompt. Jangan menyalakan
@@ -1164,7 +1193,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1164
1193
  const home = homeDir()
1165
1194
  const cur = resolvePath(cwd ?? process.cwd())
1166
1195
  if (resolvePath(home) === cur) {
1167
- process.stderr.write(
1196
+ startupWrite(
1168
1197
  c.yellow(
1169
1198
  `[warn] workspace is home directory — consider --cwd <project> to avoid scanning the entire home\n`,
1170
1199
  ),
@@ -1181,7 +1210,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1181
1210
  )
1182
1211
  const stale = checkStaleTurn(cwd, sessionId)
1183
1212
  if (stale) {
1184
- process.stderr.write(`${c.yellow(formatStaleNotice(stale))}\n`)
1213
+ startupWrite(`${c.yellow(formatStaleNotice(stale))}\n`)
1185
1214
  clearStaleTurn(cwd, sessionId)
1186
1215
  }
1187
1216
  } catch {}
@@ -1202,9 +1231,9 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1202
1231
  // ada, jadi tak ada noise pada alur normal.
1203
1232
  try {
1204
1233
  const notice = localConfigNotice(cwd ?? process.cwd(), allowLocalConfig === true)
1205
- if (notice) process.stderr.write(`${c.dim(notice)}\n`)
1234
+ if (notice) startupWrite(`${c.dim(notice)}\n`)
1206
1235
  } catch {}
1207
- if (sandboxNotice && !plan) process.stderr.write(`${sandboxNotice}\n`)
1236
+ if (sandboxNotice && !plan) startupWrite(`${sandboxNotice}\n`)
1208
1237
  // Default model = terakhir dipakai (global), bila tanpa --model dan masih
1209
1238
  // ada di config. Flag selalu menang; tak ada simpanan = provider pertama.
1210
1239
  if (!modelRef.current) {
@@ -1229,7 +1258,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1229
1258
  : (resolved.model ?? "default")
1230
1259
  if (!warnedContextModels.has(key)) {
1231
1260
  warnedContextModels.add(key)
1232
- process.stderr.write(
1261
+ startupWrite(
1233
1262
  `${c.yellow(`[context] no configured window for ${sanitizeAnsi(key)}; using fallback ${resolved.tokens} tokens. Set provider.contextWindows or --context-window for the exact limit.\n`)}`,
1234
1263
  )
1235
1264
  }
@@ -1242,7 +1271,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1242
1271
  : (resolved.model ?? "default")
1243
1272
  if (!warnedCatalogDrift.has(key)) {
1244
1273
  warnedCatalogDrift.add(key)
1245
- process.stderr.write(
1274
+ startupWrite(
1246
1275
  `${c.yellow(`[context] catalog window ${resolved.drift.catalogTokens} for ${sanitizeAnsi(key)} differs >2x from models.dev (${resolved.drift.overlayTokens}); catalog may be stale — run \`minicode pricing sync\` or set provider.contextWindows.\n`)}`,
1247
1276
  )
1248
1277
  }
@@ -1319,7 +1348,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1319
1348
  : persistedWorkMode !== undefined && persistedWorkMode !== effectiveWorkMode
1320
1349
  ? `[resume] WorkMode ${effectiveWorkMode === "EXECUTE" ? "BUILD" : effectiveWorkMode} (overriding saved ${persistedWorkMode === "EXECUTE" ? "BUILD" : persistedWorkMode})\n`
1321
1350
  : ""
1322
- if (resumeNotice) process.stderr.write(resumeNotice)
1351
+ if (resumeNotice) startupWrite(resumeNotice)
1323
1352
  // P2.4: aktivasi default Thread SEBELUM seed kernel — backfill aditif
1324
1353
  // berpagar (konten/seq tak tersentuh). Basi di sini = gagal loud
1325
1354
  // (dunia bergerak pasca-admission); warn-swallow di bawah tak berlaku.
@@ -1327,7 +1356,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1327
1356
  // idempoten) agar SEMUA baris durable beridentitas stabil.
1328
1357
  const defaultThread = ensureDefaultThread(sessionId, cwd, { expectedEpoch })
1329
1358
  const backfilled = backfillHistoryEventIds(sessionId, cwd, { expectedEpoch })
1330
- process.stderr.write(
1359
+ startupWrite(
1331
1360
  `${c.dim(`[thread sid=${sessionId} tid=${defaultThread.thread_id} head=${defaultThread.head_seq}${backfilled > 0 ? ` backfilled=${backfilled}` : ""}]\n`)}`,
1332
1361
  )
1333
1362
  try {
@@ -1426,7 +1455,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1426
1455
  contextCanonicalBaseline = prev.messages
1427
1456
  }
1428
1457
  resumeTurnCount = prev.turnCount
1429
- console.error(
1458
+ startupConsoleError(
1430
1459
  c.dim(
1431
1460
  // "(N messages)" dipertahankan VERBATIM (kontrak diagnostik yang
1432
1461
  // sudah dipakai test/CLI).
@@ -1434,7 +1463,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1434
1463
  ),
1435
1464
  )
1436
1465
  // P3.3 — jejak provenance seleksi (baca-saja; tak mengubah perilaku).
1437
- console.error(
1466
+ startupConsoleError(
1438
1467
  c.dim(
1439
1468
  `[select sid=${sessionId} basis=${selection.selectionBasis} freshness=${selection.freshness} head=${selection.frontier?.headSeq ?? "-"}]\n`,
1440
1469
  ),
@@ -1444,7 +1473,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1444
1473
  // /undo tersedia bila perlu kembali. Best-effort, tak menggagalkan resume.
1445
1474
  const div = await validateResumeWorkspace(cwd ?? ".", sessionId).catch(() => null)
1446
1475
  if (div && div.diverged > 0) {
1447
- console.error(
1476
+ startupConsoleError(
1448
1477
  c.yellow(
1449
1478
  `[resume] workspace berubah sejak checkpoint terakhir (${div.diverged} file) — /undo tersedia bila perlu kembali\n`,
1450
1479
  ),
@@ -1452,13 +1481,13 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1452
1481
  }
1453
1482
  } else {
1454
1483
  // Defensif (tak terjangkau normal: resolver menjamin baris ada).
1455
- console.error(c.yellow(`[resume] session ${sessionId} has no messages yet\n`))
1484
+ startupConsoleError(c.yellow(`[resume] session ${sessionId} has no messages yet\n`))
1456
1485
  }
1457
1486
  } catch (e) {
1458
1487
  // P2.2/P2.4: pagar basi TIDAK boleh jadi warning — lempar ulang agar
1459
1488
  // startup gagal loud (dunia bergerak pasca-admission).
1460
1489
  if (e instanceof StaleWriterError || e instanceof ThreadArchivedError) throw e
1461
- process.stderr.write(`[warn] resume failed: ${(e as Error).message}\n`)
1490
+ startupWrite(`[warn] resume failed: ${(e as Error).message}\n`)
1462
1491
  }
1463
1492
  }
1464
1493
 
@@ -1469,22 +1498,22 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1469
1498
  try {
1470
1499
  const persistedTurns = listPersistedTurns(sessionId, cwd)
1471
1500
  const rec = await planRecoveryForSession(sessionId, cwd, { persistedTurns })
1472
- for (const w of rec.warnings) process.stderr.write(c.yellow(`[recovery] ${w}\n`))
1501
+ for (const w of rec.warnings) startupWrite(c.yellow(`[recovery] ${w}\n`))
1473
1502
  if (rec.directive) {
1474
- process.stderr.write(
1503
+ startupWrite(
1475
1504
  c.yellow(`[recovery] unfinished mutations need verification — see system note\n`),
1476
1505
  )
1477
1506
  recoveryAppendix = `\n\n# Recovery note (interrupted session — verify before re-executing)\n${rec.directive}`
1478
1507
  }
1479
1508
  } catch (e) {
1480
- process.stderr.write(`[warn] recovery plan failed: ${(e as Error).message}\n`)
1509
+ startupWrite(`[warn] recovery plan failed: ${(e as Error).message}\n`)
1481
1510
  }
1482
1511
 
1483
1512
  let durablePresentationEvents: DomainEvent[] = []
1484
1513
  try {
1485
1514
  durablePresentationEvents = loadPresentationEvents(sessionId, cwd)
1486
1515
  } catch (e) {
1487
- process.stderr.write(`[warn] presentation replay load failed: ${(e as Error).message}\n`)
1516
+ startupWrite(`[warn] presentation replay load failed: ${(e as Error).message}\n`)
1488
1517
  }
1489
1518
  let rebuiltPresentation: ReturnType<typeof rebuildFromDurable> | null = null
1490
1519
  try {
@@ -1494,7 +1523,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1494
1523
  sessionId,
1495
1524
  )
1496
1525
  } catch (e) {
1497
- process.stderr.write(`[warn] presentation replay failed: ${(e as Error).message}\n`)
1526
+ startupWrite(`[warn] presentation replay failed: ${(e as Error).message}\n`)
1498
1527
  }
1499
1528
  // P2.11 — replay watershed: state.seq sesaat setelah rebuild. Baris snapshot
1500
1529
  // pada/di bawah ini = replay/reconstructed; di atasnya = live (provenance
@@ -1515,7 +1544,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
1515
1544
  try {
1516
1545
  await reconcileUndoRedoPointer(sessionId, cwd)
1517
1546
  } catch (e) {
1518
- process.stderr.write(`[warn] checkpoint reconcile failed: ${(e as Error).message}\n`)
1547
+ startupWrite(`[warn] checkpoint reconcile failed: ${(e as Error).message}\n`)
1519
1548
  }
1520
1549
 
1521
1550
  // Kontrak control-plane (Phase 6, E5): usage kompaksi LLM dikirim ke bus
@@ -3684,6 +3713,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
3684
3713
  productionScheduler,
3685
3714
  schedulerObservability,
3686
3715
  adoption,
3716
+ startupNotices: deferStartup ? startupNotices : undefined,
3687
3717
  // [P1 M14] Same rule as the Scheduler handle above: one session owns one
3688
3718
  // runtime, reachable only through the session, never through a registry.
3689
3719
  productionRuntime,
package/cli/tui.ts CHANGED
@@ -171,6 +171,13 @@ export async function runTui(ctx: CliSession): Promise<void> {
171
171
  ? ctx.getPresentationSnapshot()
172
172
  : { activities: [], turns: [] }
173
173
 
174
+ // [Fase 2] Panel aktivitas default ON di TUI (thinking + grup tool).
175
+ // Env MINICODE_ACTIVITY_PANEL=0 (opt-out eksplisit) / /fold mematikannya.
176
+ // Guard `ctx.uiState`: produksi SELALU mengoper state sesi (cli/setup.ts);
177
+ // fixture tes tanpa uiState memakai singleton `defaultUiState` — jangan
178
+ // dimutasi dari sini (bocor antar berkas tes).
179
+ if (ctx.uiState && process.env.MINICODE_ACTIVITY_PANEL !== "0") ui.setActivityPanel(true)
180
+
174
181
  let mode: string = permissions?.getMode() ?? permissionMode ?? "auto"
175
182
  // Mode permission sebelum /unrestric diaktifkan — dipakai untuk memulihkan
176
183
  // saat operator menonaktifkannya kembali (toggle, per-sesi).
@@ -264,6 +271,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
264
271
  // <id>` reuse tanpa `--resume` tak boleh menampilkan riwayat lama. Sesi baru
265
272
  // (tanpa event) = no-op. Tak double-render: replay memproses event LAMA,
266
273
  // turn live baru menyusul dengan event baru.
274
+ // Baris diagnostik startup yang didefer (resume/recovery/context/dll)
275
+ // di-flush ke transcript SEBELUM replay agar urutan kronologisnya benar
276
+ // (diagnostik dulu, lalu riwayat sesi).
277
+ if (ctx.startupNotices?.length) {
278
+ transcript.pushInfo(ctx.startupNotices)
279
+ }
267
280
  try {
268
281
  const turnCount = (session.state as { turnCount?: number } | undefined)?.turnCount ?? 0
269
282
  if (turnCount > 0) {
@@ -663,8 +676,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
663
676
  return
664
677
  }
665
678
  if (name === "fold") {
679
+ // [Fase 2] /fold = toggle PANEL AKTIVITAS (thinking + grup tool).
680
+ // Perilaku lama (minimizeActivity) tetap hidup saat panel off; `/fold`
681
+ // sekarang mengontrol panel. i18n key sama (folded/expanded).
666
682
  const next = args === "" ? undefined : args === "on" || args === "1"
667
- const on = ui.setMinimizeActivity(next)
683
+ const on = ui.setActivityPanel(next)
668
684
  transcript.pushInfo([c.muted(t("tui.activityFold", { v: on ? "folded" : "expanded" }))])
669
685
  return
670
686
  }
@@ -848,7 +864,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
848
864
  if (!res.started) {
849
865
  // Kegagalan startup adalah diagnostik, bukan keluaran program. App
850
866
  // sudah menolak membuka layar dan tidak ada fallback linear yang sah.
851
- process.stderr.write(`${t("tui.noTty")}\n`)
867
+ // Notices startup yang sempat didefer WAJIB tetap terlihat di jalur
868
+ // gagal ini (transcript tak pernah hidup) — digabung ke SATU write
869
+ // dengan pesan noTty agar inventaris writer tidak bertambah.
870
+ const deferred = ctx.startupNotices?.length ? ctx.startupNotices.join("") : ""
871
+ process.stderr.write(`${deferred}${t("tui.noTty")}\n`)
852
872
  process.exitCode = 1
853
873
  return
854
874
  }
@@ -342,7 +342,11 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
342
342
  berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
343
343
  ketikan apa pun me-reset kedua timer.
344
344
  22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
345
- transkrip expanded = alir thinking ber-warna terbaca (`c.thinking`,
345
+ dengan panel aktivitas ON (default TUI; `/fold`), transkrip menampilkan
346
+ AREA thinking = blok live maks 10 baris visual terakhir (header
347
+ `+ thinking`, penanda `… N baris lagi`), lalu saat fase berakhir diringkas
348
+ SATU baris (`+ thinking · N baris`) dengan detail penuh tetap tersedia di
349
+ `/expand`; dengan panel OFF, perilaku legacy = alir thinking ber-warna terbaca (`c.thinking`,
346
350
  abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
347
351
  jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
348
352
  = bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
@@ -379,14 +383,22 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
379
383
  dan `approval.*` terstruktur plus teks delta. Exit code, pipe safety, dan
380
384
  determinisme non-TTY tetap sama.
381
385
 
382
- 27. Painter transient stderr (spinner setup/cek-update, garis status turn)
383
- DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
386
+ 27. Painter transient stderr (spinner setup/cek-update, bar loading startup,
387
+ garis status turn) DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
384
388
  (`src/ui/runtime/statusline.ts`) membisukan `paintWrite` (nol byte + baris
385
389
  painter dibersihkan sekali saat layar mengambil alih), nested dihitung,
386
390
  release idempoten. Pemegang: `askLine`/`askSecret`/`runPicker` (raw-mode)
387
391
  dan `openAltScreen` (alt-screen, release di `close()`). Tanpa ini tick
388
392
  `\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
389
- Menyiapkan sesi…").
393
+ Menyiapkan sesi…"). Bar loading (`src/ui/runtime/loading-bar.ts`) adalah
394
+ painter transient jenis kedua: single-line blok `▓░` + persen + label,
395
+ digambar ulang HANYA saat `update(label, percent)` dipanggil (bukan
396
+ interval), TTY-only (non-TTY = no-op nol byte), label disanitasi, kursor
397
+ direstore di `exit`. Fase startup (update check/install/restart, provider,
398
+ RAG, tool, kernel, resume) memanggil `update`; diagnostik startup
399
+ (resume/recovery/context/dll) DITUNDA saat REPL dan di-flush ke transcript
400
+ TUI (`ctx.startupNotices`), sedangkan non-interaktif tetap mencetak langsung.
401
+ Output npm saat auto-update disembunyikan (`stdio: pipe` dibuang).
390
402
  28. Kontrak exit code: **0** sukses/help, **1** gagal runtime/lookup, **2**
391
403
  salah pakai (argumen hilang/malformed, subcommand asing). Flag sebagai
392
404
  positional id = salah pakai (exit 2). `exec --json` yang gagal di fase
@@ -566,6 +578,7 @@ panjang).
566
578
  - `test/tui-transcript.test.ts` — projection source-mapped: wrap, CJK/ANSI, user prefix, tabel TSV, selection text, cap buffer live, dan render markdown inline jawaban model (heading/bold/code; delimiter fence disembunyikan, isi fence dan gema user tetap literal).
567
579
  - `test/screen-buffer.test.ts` — parser frame harness (unit).
568
580
  - `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).
581
+ - `test/thinking-area.test.ts` — I22 area thinking: blok live maks 10 baris (header/`… N baris lagi`), ringkasan 1 baris + detail `/expand` saat turn selesai, tanpa duplikasi, dan fallback legacy saat panel OFF.
569
582
  - `test/presentation-projections.test.ts` — I12/I17/I32 (projection
570
583
  snapshot, running/elapsed, status terminal, retry/child grouping, summary,
571
584
  marker evict + `total()` monotonik, dan parity flag OFF) + F-AGENT-1
@@ -653,6 +666,9 @@ panjang).
653
666
  final, sementara sink linear memberi marker dan usage tetap tercatat.
654
667
  - `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
655
668
  picker/askLine, nesting, delayMs).
669
+ - `test/loading-bar.test.ts` — I27/I6 (bar loading: non-TTY no-op nol byte,
670
+ delay pertama, progres blok+persen+label, sanitasi label, stop idempoten,
671
+ restore kursor, mutual exclusion transient, ditahan layar interaktif).
656
672
  - `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
657
673
  dinonaktifkan sendiri, write asli dipulihkan).
658
674
  - `test/turn-status.test.ts` — garis status turn lifecycle deterministik