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/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
@@ -2366,6 +2395,30 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
2366
2395
  })
2367
2396
  } catch {}
2368
2397
  })
2398
+ // ── Phase C: soft-cap warning (host-side) ──
2399
+ // Peringatkan SEKALI per turn saat langkah mendekati cap (~85%) supaya operator
2400
+ // tahu batas akan tercapai dan bisa memecah/mendelegasikan sebelum tabrakan
2401
+ // keras di "Batas langkah tool tercapai". Operator-facing (stderr); menembus
2402
+ // ke MODEL butuh seam system-prompt terpisah (di luar scope fase ini).
2403
+ let softStepWarned = false
2404
+ session.events.on("turn:started", () => {
2405
+ softStepWarned = false
2406
+ })
2407
+ session.events.on("step:completed", (e) => {
2408
+ try {
2409
+ if (softStepWarned) return
2410
+ const cap = maxSteps ?? LIMITS.DEFAULT_MAX_STEPS
2411
+ const idx = (e.step as { index?: unknown })?.index
2412
+ if (typeof idx !== "number") return
2413
+ const threshold = Math.max(1, Math.floor(cap * 0.85))
2414
+ if (idx >= threshold && idx < cap) {
2415
+ softStepWarned = true
2416
+ warnLine(
2417
+ `mendekati batas langkah (step ${idx}/${cap}) — bungkus hasil, delegasikan, atau siapkan /resume`,
2418
+ )
2419
+ }
2420
+ } catch {}
2421
+ })
2369
2422
  // ── P2.11 observasi verifikasi (observation-only) ──
2370
2423
  // Bukti kanonik hidup di jurnal mutasi; presentasi hanya mengamatinya.
2371
2424
  // Setiap tool selesai (dan setiap turn selesai untuk verifikasi susulan),
@@ -3684,6 +3737,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
3684
3737
  productionScheduler,
3685
3738
  schedulerObservability,
3686
3739
  adoption,
3740
+ startupNotices: deferStartup ? startupNotices : undefined,
3687
3741
  // [P1 M14] Same rule as the Scheduler handle above: one session owns one
3688
3742
  // runtime, reachable only through the session, never through a registry.
3689
3743
  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
  }
@@ -187,14 +187,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
187
187
  hilang, id selamat).
188
188
  - Form dalam popup (`form.ts`): field text/secret(mask `•`)/select/confirm,
189
189
  Tab/↑↓ pindah, ←/→ pilih atau geser kursor, Enter validasi+submit, Esc
190
- dua-tahap (tekan-1 bersihkan field aktif, tekan-2 batal — isi tidak pernah
191
- hilang sekali tekan); error validasi merah dalam box; kursor terminal
192
- diparkir di field aktif. Add/edit provider, delete confirm, dan wizard
193
- input WAJIB lewat ini (bukan askLine liar di luar kotak).
190
+ dua-tahap (tekan-1 KEMBALIKAN nilai bawaan field aktif — text/secret/select/
191
+ confirm, tekan-2 batal — isi tidak pernah hilang sekali tekan); error
192
+ validasi merah dalam box; kursor terminal diparkir di field aktif dan field
193
+ aktif SELALU terlihat (jendela body digeser via `focusRow` bila kotak
194
+ terpotong). Add/edit provider, delete confirm, dan wizard input WAJIB lewat
195
+ ini (bukan askLine liar di luar kotak).
196
+ - Picker ber-filter: Esc-1 mengosongkan filter (= kembali ke nilai bawaan
197
+ pencarian, analogen revert-to-default I21), Esc-2 menutup. Ctrl+U juga
198
+ mengosongkan filter. Tidak ada draft yang hilang tanpa undo.
194
199
  - Dropdown `/` tetap inline menempel prompt (harus mengikuti kursor ketik):
195
200
  berbingkai, terhapus di SEMUA jalur keluar.
196
201
  - **Kursor diparkir di SEMUA permukaan** (picker/manager/form/App): baris
197
- item/field aktif — bukan ditinggal di posisi paint terakhir.
202
+ item/field aktif — bukan ditinggal di posisi paint terakhir. Kursor idle App
203
+ berada tepat setelah prompt `minicode ›` (prompt tidak lagi disembunyikan
204
+ setelah Esc/Enter kosong — I13).
198
205
  - **i18n dwibahasa** (`src/ui/i18n/`): kamus statis `en.ts`/`id.ts` (id WAJIB
199
206
  kunci = en — tsc mengawal), `t(key, params)` interpolasi `{nama}`, fallback
200
207
  kunci hilang → en. Prioritas: `/lang` (sesi) > `MINICODE_LANG` >
@@ -342,7 +349,11 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
342
349
  berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
343
350
  ketikan apa pun me-reset kedua timer.
344
351
  22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
345
- transkrip expanded = alir thinking ber-warna terbaca (`c.thinking`,
352
+ dengan panel aktivitas ON (default TUI; `/fold`), transkrip menampilkan
353
+ AREA thinking = blok live maks 10 baris visual terakhir (header
354
+ `+ thinking`, penanda `… N baris lagi`), lalu saat fase berakhir diringkas
355
+ SATU baris (`+ thinking · N baris`) dengan detail penuh tetap tersedia di
356
+ `/expand`; dengan panel OFF, perilaku legacy = alir thinking ber-warna terbaca (`c.thinking`,
346
357
  abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
347
358
  jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
348
359
  = bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
@@ -379,14 +390,22 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
379
390
  dan `approval.*` terstruktur plus teks delta. Exit code, pipe safety, dan
380
391
  determinisme non-TTY tetap sama.
381
392
 
382
- 27. Painter transient stderr (spinner setup/cek-update, garis status turn)
383
- DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
393
+ 27. Painter transient stderr (spinner setup/cek-update, bar loading startup,
394
+ garis status turn) DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
384
395
  (`src/ui/runtime/statusline.ts`) membisukan `paintWrite` (nol byte + baris
385
396
  painter dibersihkan sekali saat layar mengambil alih), nested dihitung,
386
397
  release idempoten. Pemegang: `askLine`/`askSecret`/`runPicker` (raw-mode)
387
398
  dan `openAltScreen` (alt-screen, release di `close()`). Tanpa ini tick
388
399
  `\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
389
- Menyiapkan sesi…").
400
+ Menyiapkan sesi…"). Bar loading (`src/ui/runtime/loading-bar.ts`) adalah
401
+ painter transient jenis kedua: single-line blok `▓░` + persen + label,
402
+ digambar ulang HANYA saat `update(label, percent)` dipanggil (bukan
403
+ interval), TTY-only (non-TTY = no-op nol byte), label disanitasi, kursor
404
+ direstore di `exit`. Fase startup (update check/install/restart, provider,
405
+ RAG, tool, kernel, resume) memanggil `update`; diagnostik startup
406
+ (resume/recovery/context/dll) DITUNDA saat REPL dan di-flush ke transcript
407
+ TUI (`ctx.startupNotices`), sedangkan non-interaktif tetap mencetak langsung.
408
+ Output npm saat auto-update disembunyikan (`stdio: pipe` dibuang).
390
409
  28. Kontrak exit code: **0** sukses/help, **1** gagal runtime/lookup, **2**
391
410
  salah pakai (argumen hilang/malformed, subcommand asing). Flag sebagai
392
411
  positional id = salah pakai (exit 2). `exec --json` yang gagal di fase
@@ -551,7 +570,9 @@ panjang).
551
570
  > [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
552
571
  > dipoles dengan mengganti kata-kata.
553
572
 
554
- - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (boot/exit pairing, transcript
573
+ - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (baris indikator dipotong ke
574
+ lebar frame walau locale id 51 kolom; prompt idle bertahan setelah Esc;
575
+ `repaint()` tak melukis saat suspended; boot/exit pairing, transcript
555
576
  viewport, mouse-wheel/drag-selection/PgUp/PgDn scroll + indikator, prompt
556
577
  editing, dots/timer, status bar, Esc-only abort, quit, suspend/resume,
557
578
  busy-freeze, live repaint; I14: Home/End jump + Shift+PgUp/PgDn + hint abort
@@ -566,6 +587,7 @@ panjang).
566
587
  - `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
588
  - `test/screen-buffer.test.ts` — parser frame harness (unit).
568
589
  - `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).
590
+ - `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
591
  - `test/presentation-projections.test.ts` — I12/I17/I32 (projection
570
592
  snapshot, running/elapsed, status terminal, retry/child grouping, summary,
571
593
  marker evict + `total()` monotonik, dan parity flag OFF) + F-AGENT-1
@@ -606,7 +628,21 @@ panjang).
606
628
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
607
629
  anti-hantu).
608
630
  - `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
609
- Esc-1 kembalikan prefill, Esc-2 batal).
631
+ Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
632
+ select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
633
+ lama; field aktif di luar tinggi kotak tetap terlihat).
634
+ - `test/render-audit-2026-11.test.ts` — audit renderer 2026-11-12 (proyeksi
635
+ pending dimemo per baris → tidak O(n²); SGR majemuk diproses berurutan di
636
+ `truncateToWidth`; indentasi `wordWrap`; SGR opak di highlight; cap input &
637
+ guard LCS diff; lebar tabel untuk grapheme 2 kolom; kop sesi lewat i18n;
638
+ `dialogBox` menggeser jendela ke `focusRow`) **plus penutupan kebocoran**:
639
+ `U+2028/U+2029` jadi spasi di jalur satu-baris, dan paste composer tidak
640
+ bisa menyelundupkan CSI C1 (`U+009B`) — buffer composer dilukis apa adanya,
641
+ jadi gate-nya ada di `prompt-engine` sebelum buffer terbentuk. Jalur pesan
642
+ error layar (`picker`, `model-manager`/`provider-manager` fail-open) dan
643
+ hasil probe jaringan `cli/commands.ts` (`/sync`) memakai `cleanUntrusted` /
644
+ `sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
645
+ sekadar di-import tidak menulis byte ke alt-screen.
610
646
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
611
647
  stdout-pipe tanpa sink = deny).
612
648
  - `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).
@@ -653,6 +689,9 @@ panjang).
653
689
  final, sementara sink linear memberi marker dan usage tetap tercatat.
654
690
  - `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
655
691
  picker/askLine, nesting, delayMs).
692
+ - `test/loading-bar.test.ts` — I27/I6 (bar loading: non-TTY no-op nol byte,
693
+ delay pertama, progres blok+persen+label, sanitasi label, stop idempoten,
694
+ restore kursor, mutual exclusion transient, ditahan layar interaktif).
656
695
  - `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
657
696
  dinonaktifkan sendiri, write asli dipulihkan).
658
697
  - `test/turn-status.test.ts` — garis status turn lifecycle deterministik
@@ -82,7 +82,10 @@ Tahap H — primitif render `src/ui/render/`: `sanitize.ts` (hanya SGR lolos),
82
82
  per baris → aman resize), `theme.ts` (getter warna/glyph, jangan di-`const`),
83
83
  `errors.ts` (pesan actionable + redact), `collapse.ts` (buffer `/expand`
84
84
  200KB/entry, 500KB total), `markdown-table.ts`/`table-grid.ts` (pipe-table
85
- model), `diff.ts`/`table.ts`/`money.ts`/`format.ts`.
85
+ model), `diff.ts`/`table.ts`/`money.ts`/`format.ts`,
86
+ `activity-group.ts`/`activity-panel.ts` (panel aktivitas: klasifikasi tool →
87
+ keluarga `explore|edit|execute|feed|other` + satu baris ringkas per keluarga,
88
+ maks 10 baris; murni, dipakai TUI + linear).
86
89
 
87
90
  Tahap H2 — tabel Markdown model: `src/ui/render/markdown-table.ts` memvalidasi
88
91
  header/delimiter, escaped pipe, code span, alignment, dan fence; stream block
@@ -104,8 +107,8 @@ I = bisa diinterupsi, L = bisa tiba setelah completion.
104
107
  |---|---|---|---|---|---|---|---|
105
108
  | assistant text | provider stream | stdout wrap + fence 2-spasi; pipe-table-aligned di TTY, source sanitized di non-TTY | ya | tidak (E1) | tidak | ya (abort) | tidak (detach flush 1x, E6) |
106
109
  | tool call | model → kernel | `› nama target` muted (compact: diam) | tidak | tidak | tidak | ya | tidak |
107
- | tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer | tidak | tidak | tidak | ya | tidak |
108
- | reasoning | provider extension | TUI composer: dots clock tanpa marker transcript; expanded transcript/linear tetap live per baris; minimized tetap buffer untuk `/expand` | ya | tidak | tidak | ya | tidak |
110
+ | tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer; panel aktivitas ON → baris grup per keluarga tool (`+ explore · N tools · N ok`) | tidak | tidak | tidak | ya | tidak |
111
+ | reasoning | provider extension | TUI composer: dots clock; panel aktivitas ON → AREA thinking live maks 10 baris (`+ thinking`, ringkas 1 baris saat turn selesai, detail di `/expand`); panel OFF → alir per baris; minimized → buffer `/expand` | ya | tidak | tidak | ya | tidak |
109
112
  | thinking effort | picker `/model` | badge + level per model | tidak | tidak | tidak | tidak | tidak |
110
113
  | usage | provider extension | verbose saja; masuk budget watcher | ya | tidak | ya (tail pasca-finish) | ya | ya (diabaikan aman) |
111
114
  | compaction | kernel loop | `── compacted: <reason>` kuning, reason verbatim | tidak | tidak | tidak | tidak | tidak |
@@ -9,15 +9,19 @@ Roadmap fase pemilik tidak tersedia di checkout ini; jangan simpulkan status fas
9
9
  ```
10
10
  L1 cli/ + src/ui/ → controller tipis + presentation mandiri
11
11
  L2 src/ non-ui → agen: tools, agents, hooks, policy, providers, mcp, lsp, session, skills
12
- L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (freeze, zero-dep, via #minicore)
12
+ L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (vendored, host-editable, zero-dep, via #minicore)
13
13
  ```
14
14
 
15
- Pin source kernel ada di [catatan vendor MiniCore](https://github.com/minilabs-id/minicode/blob/main/vendor/minicore/VENDOR.md):
16
- `0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
15
+ Kernel di-vendor dan **dapat diedit di host** sejak v0.16.0 (lihat
16
+ [catatan vendor MiniCore](https://github.com/minilabs-id/minicode/blob/main/vendor/minicore/VENDOR.md));
17
+ commit sumber `0d33571` hanya referensi historis provenance, bukan invarian
18
+ keras. Impor kernel aplikasi hanya melalui `#minicore`.
17
19
 
18
20
  Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
19
- diterapkan saat sinkronisasi vendor; `VENDOR.md` mem-pin source, overlay, dan
20
- fingerprint hasil akhirnya.
21
+ diterapkan saat sinkronisasi vendor. `bun run vendor:check` masih bisa dipakai
22
+ sebagai alat diagnosa provenance, tetapi bukan gate: hash yang tercatat di
23
+ `VENDOR.md` adalah checkpoint historis dan tidak ikut berubah saat kernel
24
+ diedit di host.
21
25
 
22
26
  - `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
23
27
  - Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
@@ -120,7 +124,7 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
120
124
  | stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY |
121
125
  | Keduanya | Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe |
122
126
 
123
- Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
127
+ Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard vs bar loading) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. Bar loading startup (`src/ui/runtime/loading-bar.ts`) adalah painter transient jenis kedua: single-line blok `▓░` + persen + label, digambar ulang hanya saat `update(label, percent)` dipanggil, TTY-only (non-TTY = no-op nol byte), label disanitasi. Diagnostik fase startup (identity/writer/resume/recovery/context) didefer saat REPL ke `ctx.startupNotices` dan di-flush ke transcript TUI; non-interaktif tetap mencetak langsung. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `loading-bar`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
124
128
 
125
129
  Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
126
130
 
package/docs/concepts.md CHANGED
@@ -6,7 +6,7 @@ Minicode itu apa, kenapa dibangun begitu, dan kenapa beberapa hal sengaja tidak
6
6
 
7
7
  | Nama | Apa |
8
8
  |---|---|
9
- | **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP`. Inti di-freeze, zero-dependency, di-vendor ke `vendor/minicore` (isi, jumlah file, dan hash dicatat di `vendor/minicore/VENDOR.md`). Bukan dependency — di-resolve lewat subpath imports `#minicore` |
9
+ | **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP`. Zero-dependency, di-vendor ke `vendor/minicore`; dapat diedit di host sejak v0.16.0 (angka provenance historis dicatat di `vendor/minicore/VENDOR.md`). Bukan dependency — di-resolve lewat subpath imports `#minicore` |
10
10
  | **Minicode** | Layer agencode di atasnya: tools, sub-agents, skills, hooks, policy/sandbox, providers, MCP/LSP, memory, sessions, repo-map, verifier, dan CLI dengan TUI interaktif serta jalur non-interaktif shell-first |
11
11
 
12
12
 
@@ -45,14 +45,15 @@ Gerbang lambat/stokastik (docker sandbox) tinggal di `slow.yml` — kegagalannya
45
45
 
46
46
  ### Budget ukuran paket (3.968 KiB)
47
47
 
48
- `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 3.968 KiB (3,875 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
48
+ `bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 4.096 KiB (4,0 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
49
49
 
50
- Batas 3.968 KiB disetujui pemilik pada 2026-11-10 untuk rilis v0.17.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
50
+ Batas 4.096 KiB disetujui pemilik pada 2026-11-11 untuk rilis v0.21.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
51
51
 
52
52
  Gerbang lain:
53
53
 
54
54
  ```bash
55
- bun run gate:bash # 62 pola serangan + 24 perintah sah → 0 bypass / 0 over-block
55
+ bun run gate:bash # korpus pola serangan + perintah sah (auto & allowlist) → 0 bypass / 0 over-block
56
+ # hitungan tercetak oleh probe itu sendiri; jangan disalin ke dokumen
56
57
  bun run bench:smoke # fake, CI-safe
57
58
  bun run vendor:check # provenance MiniCore (soft; vendor host-editable sejak v0.16.0)
58
59
  ```
@@ -69,6 +69,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
69
69
  |---|---|
70
70
  | `MINICODE_BUDGET_STRICT` | `1` → penegasan eksplisit fail-closed (cost tak dikenal + pemakaian = over; kini juga default `--budget`) |
71
71
  | `MINICODE_MAX_TURNS` | Batas keras maksimum jumlah turn per sesi (termasuk carry-forward lintas `--resume`; bilangan ≥1) |
72
+ | `MINICODE_AUTO_CONTINUE` | `1` → pada `exec`, saat turn berakhir `max_steps_exceeded`, lanjutkan turn pada sesi yang sama (progres parsial sudah durable) alih-alih gagal; dibatasi `--max-turns` (default 3) |
72
73
  | `MINICODE_ALLOW_LOCAL_CONFIG` | `1` → percayai config lokal workspace (default: diabaikan) |
73
74
 
74
75
  ## Terminal & aksesibilitas
@@ -86,6 +87,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
86
87
  | `MINICODE_A11Y` | `1` → live-region approval untuk screen reader (baris polos tanpa ANSI) |
87
88
  | `MINICODE_SHOW_THINKING` | reasoning model terlihat SECARA DEFAULT; `0` → minimized (hanya penanda), `1` → paksa terlihat |
88
89
  | `MINICODE_MINIMIZE_ACTIVITY` | ON secara default di TUI; `0` → transparan (baris per-tool). Lipat aktivitas tool per turn jadi satu ringkasan (detail via `/expand`) |
90
+ | `MINICODE_ACTIVITY_PANEL` | `0` → matikan panel aktivitas (default AKTIF di TUI; `/fold` toggle); `1` → paksa aktif juga di jalur linear/one-shot |
89
91
  | `MINICORE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek). Alias lama `MINICODE_THINKING` masih dihormati |
90
92
  | `NO_COLOR` | Set apa pun selain `0` → matikan seluruh warna |
91
93