minicode-ai 0.9.29 → 0.11.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 (141) hide show
  1. package/AGENTS.md +45 -0
  2. package/CHANGELOG.md +79 -1
  3. package/PLAN.md +491 -0
  4. package/README.md +2 -2
  5. package/cli/args.ts +1 -0
  6. package/cli/commands/acp.ts +485 -0
  7. package/cli/commands/auth.ts +7 -4
  8. package/cli/commands/config.ts +41 -27
  9. package/cli/commands/exec.ts +33 -12
  10. package/cli/commands/mcp.ts +3 -2
  11. package/cli/commands/memory.ts +1 -1
  12. package/cli/commands/pricing.ts +6 -4
  13. package/cli/commands/providers.ts +18 -8
  14. package/cli/commands/sessions.ts +11 -4
  15. package/cli/commands/skills.ts +3 -3
  16. package/cli/commands/stats.ts +3 -1
  17. package/cli/commands.ts +225 -103
  18. package/cli/index.ts +89 -62
  19. package/cli/model-manager.ts +8 -8
  20. package/cli/provider-manager.ts +13 -13
  21. package/cli/router.ts +7 -0
  22. package/cli/setup.ts +349 -4
  23. package/cli/tui.ts +542 -0
  24. package/cli/wizard.ts +2 -1
  25. package/docs/ARCHITECTURE.html +62 -36
  26. package/docs/CONTROL-PLANE-MAP.md +139 -0
  27. package/docs/HARNESS.md +150 -0
  28. package/docs/PLAN_UIUX_V6.md +209 -0
  29. package/docs/README.md +1 -1
  30. package/docs/SUMMARY.md +52 -0
  31. package/docs/TERMINAL_CONTRACT.md +367 -0
  32. package/docs/UI_RENDER_PIPELINE.md +165 -0
  33. package/docs/USAGE.md +11 -0
  34. package/docs/agents.md +31 -0
  35. package/docs/architecture.md +3 -3
  36. package/docs/choosing-mode.md +34 -0
  37. package/docs/cli.md +130 -0
  38. package/docs/concepts.md +53 -0
  39. package/docs/config-providers.md +87 -0
  40. package/docs/config.md +63 -0
  41. package/docs/contributing.md +79 -0
  42. package/docs/environment.md +95 -0
  43. package/docs/exec.md +73 -0
  44. package/docs/getting-started.md +102 -0
  45. package/docs/glossary.md +37 -0
  46. package/docs/mcp-lsp.md +54 -0
  47. package/docs/memory-sessions.md +63 -0
  48. package/docs/policy-sandbox.md +72 -0
  49. package/docs/pricing-budget.md +49 -0
  50. package/docs/quickstart.md +60 -0
  51. package/docs/repl.md +67 -0
  52. package/docs/security-model.md +95 -0
  53. package/docs/security.md +91 -0
  54. package/docs/skills.md +48 -0
  55. package/docs/terminal.md +79 -0
  56. package/docs/tools.md +123 -0
  57. package/docs/troubleshooting.md +40 -0
  58. package/docs/verify-benchmark.md +58 -0
  59. package/package.json +8 -5
  60. package/src/app/provider-layer.ts +12 -4
  61. package/src/app/rag-layer.ts +7 -2
  62. package/src/app/session.ts +6 -0
  63. package/src/app/tool-layer.ts +2 -1
  64. package/src/config.ts +30 -1
  65. package/src/constants.ts +35 -0
  66. package/src/lib/net.ts +6 -1
  67. package/src/lsp/client.ts +41 -8
  68. package/src/mcp/http-transport.ts +52 -15
  69. package/src/mcp/transport.ts +32 -1
  70. package/src/memory/files.ts +6 -5
  71. package/src/policy/allowlist.ts +1 -1
  72. package/src/policy/bash-guard.ts +213 -17
  73. package/src/policy/compaction.ts +57 -3
  74. package/src/policy/context.ts +4 -0
  75. package/src/policy/jail.ts +49 -4
  76. package/src/policy/permission.ts +152 -12
  77. package/src/policy/pricing.ts +12 -9
  78. package/src/policy/update-check.ts +4 -1
  79. package/src/presentation/adapter.ts +721 -0
  80. package/src/presentation/events.ts +324 -0
  81. package/src/presentation/label.ts +140 -0
  82. package/src/presentation/model.ts +172 -0
  83. package/src/presentation/reducer.ts +486 -0
  84. package/src/presentation/store.ts +256 -0
  85. package/src/providers/anthropic.ts +22 -4
  86. package/src/providers/detect.ts +2 -1
  87. package/src/providers/router.ts +13 -0
  88. package/src/repo/repomap.ts +2 -29
  89. package/src/session/checkpoint.ts +27 -9
  90. package/src/session/journal.ts +27 -5
  91. package/src/skills/loader.ts +88 -5
  92. package/src/telemetry/trace.ts +36 -15
  93. package/src/tools/ask_user.ts +73 -4
  94. package/src/tools/bash.ts +23 -17
  95. package/src/tools/glob.ts +10 -11
  96. package/src/tools/lsp.ts +3 -56
  97. package/src/tools/memory.ts +13 -12
  98. package/src/tools/task.ts +7 -1
  99. package/src/tools/web_fetch.ts +11 -2
  100. package/src/tools/web_search.ts +4 -1
  101. package/src/ui/approval/prompt.ts +96 -22
  102. package/src/ui/assistant/simple.ts +188 -44
  103. package/src/ui/assistant/turn-status.ts +32 -10
  104. package/src/ui/contract.ts +119 -0
  105. package/src/ui/footer.ts +35 -14
  106. package/src/ui/i18n/en.ts +253 -0
  107. package/src/ui/i18n/id.ts +255 -0
  108. package/src/ui/i18n/locale.ts +68 -0
  109. package/src/ui/input/input.ts +189 -81
  110. package/src/ui/input/prompt-engine.ts +139 -4
  111. package/src/ui/render/collapse.ts +20 -13
  112. package/src/ui/render/diff.ts +7 -2
  113. package/src/ui/render/errors.ts +75 -50
  114. package/src/ui/render/format.ts +26 -8
  115. package/src/ui/render/highlight.ts +12 -5
  116. package/src/ui/render/markdown.ts +5 -1
  117. package/src/ui/render/sanitize.ts +29 -2
  118. package/src/ui/render/table.ts +12 -6
  119. package/src/ui/render/theme.ts +23 -4
  120. package/src/ui/render/width.ts +104 -17
  121. package/src/ui/runtime/motion.ts +16 -0
  122. package/src/ui/runtime/screen.ts +242 -0
  123. package/src/ui/runtime/spinner.ts +50 -4
  124. package/src/ui/runtime/statusline.ts +50 -1
  125. package/src/ui/screens/dialog.ts +174 -0
  126. package/src/ui/screens/form.ts +486 -0
  127. package/src/ui/screens/model-manager.ts +289 -134
  128. package/src/ui/screens/picker.ts +264 -109
  129. package/src/ui/screens/provider-manager.ts +385 -172
  130. package/src/ui/screens/wizard.ts +165 -102
  131. package/src/ui/tui/app.ts +951 -0
  132. package/src/ui/tui/transcript.ts +475 -0
  133. package/vendor/minicore/LICENSE +21 -0
  134. package/vendor/minicore/VENDOR.md +6 -3
  135. package/vendor/minicore/package.json +6 -3
  136. package/vendor/minicore/src/core/loop.ts +12 -2
  137. package/vendor/minicore/src/core/snapshot.ts +4 -0
  138. package/vendor/minicore/src/providers/openai-compat.ts +76 -25
  139. package/cli/repl.ts +0 -740
  140. package/src/ui/runtime/chrome.ts +0 -369
  141. package/src/ui/screens/overlay.ts +0 -61
@@ -464,7 +464,7 @@ footer.site .spacer { flex: 1; }
464
464
  <span class="mi">search</span><span>Cari modul, simbol, env…</span><kbd>Ctrl K</kbd>
465
465
  </div>
466
466
  <div class="top-actions">
467
- <span class="vpill hide-m">v0.9.28 · Bun-only · 0 deps</span>
467
+ <span class="vpill hide-m">v0.11.0 · Bun-only · 0 deps</span>
468
468
  <button class="iconbtn" id="themeBtn" aria-label="Ganti tema terang/gelap" title="Ganti tema"><span class="mi">dark_mode</span></button>
469
469
  </div>
470
470
  </header>
@@ -543,7 +543,7 @@ footer.site .spacer { flex: 1; }
543
543
  <div class="meta">
544
544
  <span class="pill blue"><span class="dot"></span>entry: cli/index.ts</span>
545
545
  <span class="pill green"><span class="dot"></span>37 tool bawaan</span>
546
- <span class="pill">kernel ae9d1be · lihat vendor/minicore/VENDOR.md</span>
546
+ <span class="pill">kernel 0d33571 · lihat vendor/minicore/VENDOR.md</span>
547
547
  </div>
548
548
 
549
549
  <div class="card-grid">
@@ -594,7 +594,7 @@ footer.site .spacer { flex: 1; }
594
594
  </div>
595
595
 
596
596
  <div class="hint hint-info"><span class="ico"><span class="mi">layers</span></span><div class="body"><span class="title">Lapisan logis ≠ struktur direktori</span><code>src/ui/</code> secara fisik ada di <code>src/</code> tetapi bermain di <span class="chip c1">L1</span> — lapisan ditentukan peran, bukan lokasi folder.</div></div>
597
- <div class="hint hint-purple"><span class="ico"><span class="mi">cable</span></span><div class="body"><span class="title">Satu-satunya jembatan UI ↔ agen</span>Data masuk UI lewat kontrak tipe struktural di <code>src/ui/contract.ts</code> (<code>UiEvent</code>, <code>UiBus</code>, <code>UiStep</code>, <code>UiExecution</code>, <code>UiToolCallRef</code>). Kemampuan agen masuk UI lewat <b>callback yang di-inject</b> dari composition root <code>cli/setup.ts</code> (<code>ask</code>, <code>setupWhenEmpty</code>). UI tidak pernah menyentuh config, disk, atau kernel.</div></div>
597
+ <div class="hint hint-purple"><span class="ico"><span class="mi">cable</span></span><div class="body"><span class="title">Satu-satunya jembatan UI ↔ agen</span>Data masuk UI lewat kontrak tipe struktural di <code>src/ui/contract.ts</code> (<code>UiEvent</code>, <code>UiBus</code>, <code>UiStep</code>, <code>UiExecution</code>, <code>UiToolCallRef</code>). Kemampuan agen masuk UI lewat <b>callback yang di-inject</b> dari composition root <code>cli/setup.ts</code> (<code>ask</code>, <code>setupWhenEmpty</code>, snapshot/event presentasi). UI tidak pernah menyentuh config, disk, atau kernel.</div></div>
598
598
  <div class="hint hint-ok"><span class="ico"><span class="mi">link</span></span><div class="body"><span class="title">Pola DI yang sama berlaku di luar UI</span><code>setSubAgentSessionFactory</code> (cli/index.ts → delegate_task), <code>ask</code> (approval), <code>setupWhenEmpty</code> (wizard). Tanpa injeksi, perilaku default selalu aman: deny / tolak jalan. Subpath <code>#minicore</code> (package.json <code>imports</code>) adalah satu-satunya pintu kode ke L3.</div></div>
599
599
  <div class="hint hint-warn"><span class="ico"><span class="mi">warning</span></span><div class="body"><span class="title">Mengapa tiga lapisan?</span>Kernel dapat disinkron/diganti tanpa menyentuh aplikasi; kebijakan keamanan berdiri di L2 sehingga otomatis berlaku untuk semua tool (bawaan maupun MCP); UI bebas berubah tanpa memengaruhi logika — dan sebaliknya.</div></div>
600
600
  </section>
@@ -606,7 +606,7 @@ footer.site .spacer { flex: 1; }
606
606
  <div class="steps">
607
607
  <div class="step"><div class="dot">1</div><div class="card-b"><b>Entry &amp; parsing</b>
608
608
  <span class="where">cli/index.ts → cli/args.ts → cli/router.ts</span>
609
- <span class="what">argv dipisah jadi flag &amp; prompt; dispatch ke subcommand (auth/config/exec/mcp/pricing/providers/sessions/skills/stats) atau REPL. Flag tak dikenal tidak error — ia jadi kata prompt (§8).</span>
609
+ <span class="what">argv dipisah jadi flag &amp; prompt; dispatch ke subcommand (acp/auth/config/exec/mcp/pricing/providers/sessions/skills/stats/memory/doctor) atau REPL. Flag tak dikenal tidak error — ia jadi kata prompt (§8).</span>
610
610
  </div></div>
611
611
  <div class="step"><div class="dot">2</div><div class="card-b"><b>Perakitan sesi</b>
612
612
  <span class="where">cli/setup.ts → src/app/session.ts → src/app/{provider,tool,rag}-layer.ts</span>
@@ -647,15 +647,15 @@ footer.site .spacer { flex: 1; }
647
647
  <div class="empty-note" id="emptyNote">Tidak ada modul yang cocok. Kosongkan saringan untuk melihat semua.</div>
648
648
 
649
649
  <details class="group" id="g-cli" open>
650
- <summary><span class="chip c1">L1</span> cli/ <span class="role">— entry point, subcommand, penggerak REPL, controller layar</span> <span class="cnt">8 modul</span></summary>
650
+ <summary><span class="chip c1">L1</span> cli/ <span class="role">— entry point, subcommand, penggerak TUI, controller layar</span> <span class="cnt">8 modul</span></summary>
651
651
  <div class="mods">
652
652
  <div class="mod"><div class="fname">index.ts</div><div class="fdesc">Entry utama (bin package.json): parsing argv, HELP/versi, rute subcommand vs REPL; wiring DI factory sub-agen (setSubAgentSessionFactory) sebelum dispatch.</div><div class="exports">titik masuk — dieksekusi, tidak diimpor</div></div>
653
653
  <div class="mod"><div class="fname">args.ts</div><div class="fdesc">Parsing argumen murni: whitelist flag, bentuk <code>--f v</code> &amp; <code>--f=v</code>, baca stdin.</div><div class="exports">getArg · promptFromArgs · readPrompt</div></div>
654
654
  <div class="mod"><div class="fname">setup.ts</div><div class="fdesc">Composition root: rakit config + kernel session + tools + permission; inject wizard (setupWhenEmpty) dan approval (ask) ke lapisan logika; pemutus budget mid-turn (watchBudgetLimit menggugurkan turn via abort begitu pagu lewat).</div><div class="exports">createCliSession · CliSession</div></div>
655
655
  <div class="mod"><div class="fname">router.ts</div><div class="fdesc">Dispatch prompt ke provider dengan retry/backoff sisi CLI.</div><div class="exports">dispatch</div></div>
656
- <div class="mod"><div class="fname">commands.ts</div><div class="fdesc">Registry slash builtin + eksekusinya. DRIVER_HELP_COMMANDS = perintah driver yang tampil di /help tapi TIDAK di dropdown (mode/undo/redo/clear/copy/history). /thinking = toggle tampilan reasoning (expand/minimize); effort via picker Enter di /model.</div><div class="exports">handleBuiltinCommand · BUILTIN_COMMANDS · DRIVER_HELP_COMMANDS · /help /provider /model /sync /status /sessions /init /exit /compact</div></div>
657
- <div class="mod"><div class="fname">repl.ts</div><div class="fdesc">Driver REPL linier: loop askLine + dispatch slash/skill/prompt langsung ke scrollback; raw mode saat busy untuk tombol + / - / Ctrl+T (section collapse live), interupsi Ctrl+C saat busy (SIGINT + byte \x03; pipe/CI tanpa tombol live), budget di driver; /expand membuka buffer section, /minimize mengecilkan; Tab kosong toggle plan/build; did-you-mean untuk typo slash.</div><div class="exports">runRepl · suggestSimilar · applyBusyKey</div></div>
658
- <div class="mod"><div class="fname">commands/ — 11 berkas, satu per subcommand</div><div class="fdesc">auth.ts · config.ts · exec.ts · mcp.ts · pricing.ts · providers.ts · sessions.ts · skills.ts · stats.ts · memory.ts (status RAG: rows/size/hit-rate) · doctor.ts (diagnosis lokal)</div><div class="exports">handleAuth · handleConfig · handleExec · handleMcp · handlePricing · handleProviders · handleSessions · handleSkills · handleStats · handleMemory · handleDoctor</div></div>
656
+ <div class="mod"><div class="fname">commands.ts</div><div class="fdesc">Registry slash builtin + eksekusinya. DRIVER_HELP_COMMANDS = perintah driver yang tampil di /help tapi TIDAK di dropdown (mode/undo/redo/clear/copy/history). /thinking = toggle tampilan reasoning (expand/minimize); effort via picker Enter di /model. /status = jendela info (pin `p` = cetak); /sessions tanpa arg = picker overlay (pilih = resume), kosong/non-TTY = satu baris cetak.</div><div class="exports">handleBuiltinCommand · BUILTIN_COMMANDS · DRIVER_HELP_COMMANDS · /help /provider /model /sync /status /sessions /init /exit /compact</div></div>
657
+ <div class="mod"><div class="fname">tui.ts</div><div class="fdesc">Driver TUNGGAL (satu-satunya tampilan interaktif): susun TuiHost dari CliSession lalu jalankan App fullscreen + daftarkan approval sink. Semua output ke Transcript (capture console.log selama handleBuiltinCommand). /status &amp; /history &amp; /help ringkas = readout transkrip; /model &amp; /provider &amp; /sessions = popup komposit via app.suspend()/resume(); /expand membuka buffer; histori prompt memori-sesi. REPL linier dihapus.</div><div class="exports">runTui</div></div>
658
+ <div class="mod"><div class="fname">commands/ — 12 berkas, satu per subcommand</div><div class="fdesc">auth.ts · config.ts · exec.ts · mcp.ts · pricing.ts · providers.ts · sessions.ts · skills.ts · stats.ts · memory.ts (status RAG: rows/size/hit-rate) · doctor.ts (diagnosis lokal) · acp.ts (server JSON-RPC stdio untuk IDE: initialize/run/cancel/shutdown, deny-headless; dengan flag V2 mengirim notifikasi lifecycle turn/tool/approval terstruktur)</div><div class="exports">handleAuth · handleConfig · handleExec · handleMcp · handlePricing · handleProviders · handleSessions · handleSkills · handleStats · handleMemory · handleDoctor · handleAcp</div></div>
659
659
  <div class="mod"><div class="fname">wizard.ts · model-manager.ts · provider-manager.ts · auto-update.ts</div><div class="fdesc">Controller tipis: pegang CRUD config, panggil view murni di src/ui/screens/. /model Enter = pilih + picker thinking effort (Esc = batal total) via onSelect + onSetEffort; mutasi ditulis ke file scope asal provider; badge effort non-default di baris. auto-update.ts = cek/update mandiri (maybeAutoUpdate).</div></div>
660
660
  </div>
661
661
  </details>
@@ -672,7 +672,7 @@ footer.site .spacer { flex: 1; }
672
672
  </details>
673
673
 
674
674
  <details class="group" id="g-policy" open>
675
- <summary><span class="chip c2">L2</span> src/policy/ <span class="role">— semua kebijakan izin &amp; keamanan agen</span> <span class="cnt">10 modul</span></summary>
675
+ <summary><span class="chip c2">L2</span> src/policy/ <span class="role">— semua kebijakan izin &amp; keamanan agen</span> <span class="cnt">11 modul</span></summary>
676
676
  <div class="mods">
677
677
  <div class="mod"><div class="fname">permission.ts</div><div class="fdesc">Handler 6 mode: auto/ask/readonly/plan/allowlist/allow-all; kunci per tool. Allowlist lokal hanya dibaca bila opt-in <code>--allow-local-config</code>; grant "always" sesi ini disimpan in-memory.</div><div class="exports">createPermissionHandler · PermissionMode · PermissionAsk</div></div>
678
678
  <div class="mod"><div class="fname">allowlist.ts</div><div class="fdesc">Allowlist tool (global + proyek, merge dedup); pola wildcard <code>tool:args</code> — dipakai mode allowlist &amp; jawaban “always” di mode ask.</div><div class="exports">loadAllowlist · saveAllowlist · matchAllowlist · Allowlist</div></div>
@@ -683,6 +683,7 @@ footer.site .spacer { flex: 1; }
683
683
  <div class="mod"><div class="fname">pricing.ts · usage.ts</div><div class="fdesc">Tabel harga model; kolektor token &amp; biaya.</div></div>
684
684
  <div class="mod"><div class="fname">ratelimit.ts · sandbox-policy.ts</div><div class="fdesc">Batas laju permintaan; kebijakan fallback sandbox.</div></div>
685
685
  <div class="mod"><div class="fname">scrub.ts · verifier.ts</div><div class="fdesc">Pembersihan data sensitif; verifikasi hasil (mode --verify).</div></div>
686
+ <div class="mod"><div class="fname">update-check.ts</div><div class="fdesc">Update notifier: cek versi npm (cache 24 jam, fire-and-forget 2 dtk); diam saat offline; hormat NO_UPDATE_CHECK=1/CI=1.</div><div class="exports">isNewer · shouldAutoUpdate · installUpdate · formatUpdateMessage</div></div>
686
687
  <div class="mod"><div class="fname">executor.ts — urutan gerbang</div><div class="fdesc">Urutan tetap: jail → permission → bash-guard → validateArgs → execute → truncation. Jangan sisipkan gerbang baru tanpa test di test/.</div></div>
687
688
  </div>
688
689
  </details>
@@ -707,7 +708,7 @@ footer.site .spacer { flex: 1; }
707
708
  </details>
708
709
 
709
710
  <details class="group" id="g-providers">
710
- <summary><span class="chip c2">L2</span> src/providers/ <span class="role">— koneksi model</span> <span class="cnt">6 modul</span></summary>
711
+ <summary><span class="chip c2">L2</span> src/providers/ <span class="role">— koneksi model</span> <span class="cnt">8 modul</span></summary>
711
712
  <div class="mods">
712
713
  <div class="mod"><div class="fname">router.ts</div><div class="fdesc">Pilih provider untuk satu request (byId per-stream + updateProviders agar provider baru langsung dikenali; fallback berantai; 429 + retry-after ditunggu — cap 30 dtk — lalu fallback, atau coba-ulang-di-tempat bila provider tunggal). Menyelipkan system prompt sebagai pesan user pertama untuk adapter tanpa dukungan system native (openai-compat; Anthropic/Responses diurus di adapter).</div><div class="exports">createRouterProvider · updateProviders</div></div>
713
714
  <div class="mod"><div class="fname">anthropic.ts</div><div class="fdesc">Adapter Anthropic native (stream SSE).</div></div>
@@ -715,48 +716,63 @@ footer.site .spacer { flex: 1; }
715
716
  <div class="mod"><div class="fname">build.ts · detect.ts · presets.ts</div><div class="fdesc">Bangun adapter (termasuk Responses API + peta reasoningEffort); deteksi tipe dari probe (path /responses → responses), bukan substring URL; preset provider populer.</div></div>
716
717
  <div class="mod"><div class="fname">provision.ts</div><div class="fdesc">Provisioning provider: deteksi model + simpan/hapus/sinkron entri config. Dipisah dari config.ts agar config murni IO — arah satu arah: providers → config.</div><div class="exports">saveProvider · detectAndSave · deriveProviderId · removeProvider · refreshProviderModels</div></div>
717
718
  <div class="mod"><div class="fname">oauth.ts · auth-store.ts</div><div class="fdesc">Alur OAuth dan penyimpanan kredensial.</div></div>
719
+ <div class="mod"><div class="fname">effort.ts</div><div class="fdesc">Thinking per keluarga model (fail-soft universal): reasoning_effort/budget/adaptive hanya untuk keluarga reasoning terbukti; default = omit (tune vendor).</div><div class="exports">thinkingFamily · allowedEfforts · effortOptionsForModel · withEffortFallback</div></div>
720
+ <div class="mod"><div class="fname">guards.ts</div><div class="fdesc">Penjaga stream semua adapter: fetch timeout (server hung = ProviderError server) + text-cap anti-OOM; preservasi kind/chain.</div><div class="exports">withStreamGuards</div></div>
718
721
  </div>
719
722
  </details>
720
723
 
721
724
  <details class="group" id="g-session">
722
- <summary><span class="chip c2">L2</span> src/session/ <span class="role">— persistensi, checkpoint &amp; jurnal recovery</span> <span class="cnt">4 modul</span></summary>
725
+ <summary><span class="chip c2">L2</span> src/session/ <span class="role">— persistensi, checkpoint &amp; jurnal recovery</span> <span class="cnt">5 modul</span></summary>
723
726
  <div class="mods">
724
727
  <div class="mod"><div class="fname">persistence.ts</div><div class="fdesc">sqlite WAL: simpan pesan inkremental, daftar sesi, purge TTL, fork sesi (branch).</div><div class="exports">saveSession · loadSession · listSessions · deleteSession · branchSession · purgeExpired · getSessionTtlDays</div></div>
725
728
  <div class="mod"><div class="fname">shadow-git.ts</div><div class="fdesc">SHA tree git per turn di refs/minicode/* — tanpa menyentuh HEAD/index user.</div><div class="exports">ShadowSnapshot · ShadowChange · RestoreResult</div></div>
726
729
  <div class="mod"><div class="fname">checkpoint.ts</div><div class="fdesc">Manifes checkpoint di .minicode/checkpoints/ (maks 20) + undo per turn + validasi resume (divergensi workspace vs checkpoint terakhir, .minicode/ dikecualikan). Protokol undo/redo uniform: apply → marker jurnal (newIndex) → save pointer; crash di antaranya dipulihkan <code>reconcileUndoRedoPointer</code> dari marker (metadata-only, tanpa re-eksekusi).</div><div class="exports">Checkpoint · CheckpointManifest · FileSnapshot · validateResumeWorkspace · reconcileUndoRedoPointer</div></div>
727
730
  <div class="mod"><div class="fname">journal.ts</div><div class="fdesc">Mutation intent journal: status komitmen per mutasi (pending/committed/failed/finalized) via event execution:started/completed — menjawab "sudah/belum/ambigu" saat resume. File dibuat eager saat attach (empty ≠ absent); turn namespace per-sesi (anak tak cross-match parent); delegasi ter-cover transitif. Terminal bukti dedup (<code>dedup: true</code>, mis. MCP request id+hash) selamat dari sweep agar retry id-sama pasca-restart tetap terdeteksi. BUKAN transaksi: pending = ambigu (verify dulu), committed ≠ turn durable, MCP = external-acknowledged.</div><div class="exports">appendMutationIntent · appendMutationTerminal · decideRecovery · attachMutationJournal · planRecoveryForSession · classifyTool · findOrphanJournals</div></div>
731
+ <div class="mod"><div class="fname">turn-marker.ts</div><div class="fdesc">Penanda turn-aktif (pid + sessionId) untuk deteksi mati-tak-wajar (kill -9/segfault): sisa saat startup = proses lama mati di tengah turn; hanya marker yatim (pid mati, sessionId cocok) yang dilaporkan + dibersihkan.</div><div class="exports">markTurnActive · clearTurnActive · checkStaleTurn · clearStaleTurn</div></div>
728
732
  </div>
729
733
  </details>
730
734
 
731
735
  <details class="group" id="g-ui">
732
- <summary><span class="chip c1">L1</span> src/ui/ <span class="role">— presentation mandiri · DILARANG impor cli/ · src/ non-ui · #minicore</span> <span class="cnt">19 modul</span></summary>
736
+ <summary><span class="chip c1">L1</span> src/ui/ <span class="role">— presentation mandiri · DILARANG impor cli/ · src/ non-ui · #minicore</span> <span class="cnt">20 modul</span></summary>
733
737
  <div class="mods">
734
- <div class="mod"><div class="fname">contract.ts</div><div class="fdesc">Satu-satunya bentuk data yang mengalir ke UI; EventBus kernel kompatibel struktural.</div><div class="exports">UiBus · UiEvent · UiEventType · UiStep · UiExecution · UiToolCallRef</div></div>
738
+ <div class="mod"><div class="fname">contract.ts</div><div class="fdesc">Satu-satunya bentuk data yang mengalir ke UI; EventBus kernel kompatibel struktural. Fase 2: UiToolCallRef.id (toolCallId utuh) + UiStep.results ringkas — aditif, field opsional. Fase 5–6: snapshot/event presentasi struktural (activity, turn, approval, lifecycle) masuk lewat callback composition root tanpa mengimpor src/presentation.</div><div class="exports">UiBus · UiEvent · UiEventType · UiStep · UiStepResultRef · UiExecution · UiToolCallRef · UiToolStatus · UiTurnSummary · UiPresentationError · UiPresentationReceipt · UiPresentationActivity · UiPresentationTurn · UiPresentationSnapshot · UiApprovalOutcome · UiPresentationEvent</div></div>
735
739
  <div class="mod"><div class="fname">render/theme.ts</div><div class="fdesc">Warna &amp; glyph sebagai GETTER runtime (UTF-8, NO_COLOR) — jangan bekukan ke const. Palet tunggal; auto-detect: NO_COLOR &gt; stdout TTY &gt; truecolor &gt; 256 &gt; 16 &gt; mono. Warna MATI saat stdout bukan TTY. Fitur tema (--theme, /theme, preset) dihapus.</div></div>
736
740
  <div class="mod"><div class="fname">render/sanitize.ts</div><div class="fdesc">sanitizeAnsi — hanya loloskan SGR; wajib untuk teks tak terpercaya.</div><div class="exports">sanitizeAnsi</div></div>
737
741
  <div class="mod"><div class="fname">render/width.ts · wrap.ts</div><div class="fdesc">Ukur teks dalam KOLOM (CJK/emoji = 2); pembungkus + justify.</div><div class="exports">displayWidth · truncateToWidth · padToWidth</div></div>
738
742
  <div class="mod"><div class="fname">render/markdown.ts · highlight.ts</div><div class="fdesc">Dekorasi markdown ke ANSI; syntax highlight kode.</div></div>
739
- <div class="mod"><div class="fname">render/format.ts · diff.ts · table.ts · money.ts · reasoning.ts · collapse.ts</div><div class="fdesc">Format event (tipe lokal), render diff, tabel, biaya, toggle reasoning, section collapse (+ / - dengan buffer untuk /expand).</div><div class="exports">reasoning (visible) · sectionMinimized · setSectionMinimized · bufferSection · getBufferedSections</div></div>
743
+ <div class="mod"><div class="fname">render/format.ts · diff.ts · table.ts · money.ts · reasoning.ts · collapse.ts</div><div class="fdesc">Format event (tipe lokal), render diff, tabel, biaya, toggle reasoning, section collapse (+ / - dengan collapsed view untuk /expand).</div><div class="exports">reasoning (visible) · sectionMinimized · setSectionMinimized · rememberCollapsedSection · collapsedSectionsSnapshot</div></div>
740
744
  <div class="mod"><div class="fname">render/errors.ts</div><div class="fdesc">Format error provider jadi bahasa ramah user.</div><div class="exports">friendlyError · formatFriendly</div></div>
741
745
  <div class="mod"><div class="fname">render/detail.ts</div><div class="fdesc">Mode compact/expanded global (MINICODE_COMPACT, /compact, Ctrl+O).</div><div class="exports">detail · setCompactMode</div></div>
742
- <div class="mod"><div class="fname">runtime/statusline.ts</div><div class="fdesc">ARBITRASE SATU-SATUNYA untuk semua transient stderr: <code>acquireTransientPaint(kind)</code> (turn-painter vs wizard-spinner, overlap = signal <code>[transient-paint]</code>) + <code>paintWrite</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen; koordinasi suspend/resume baris status vs printer linier.</div><div class="exports">acquireTransientPaint · paintWrite · isTransientPainting · registerStatusLine · runWithoutStatus</div></div>
746
+ <div class="mod"><div class="fname">runtime/statusline.ts</div><div class="fdesc">ARBITRASE SATU-SATUNYA untuk semua transient stderr: <code>acquireTransientPaint(kind)</code> (turn-painter vs wizard-spinner, overlap = signal <code>[transient-paint]</code>) + <code>paintWrite</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen; koordinasi suspend/resume baris status vs printer linier; <code>beginInteractiveScreen()</code> MENAHAN semua painter selama layar raw/alt memegang terminal (nested, release idempoten).</div><div class="exports">acquireTransientPaint · paintWrite · isTransientPainting · registerStatusLine · runWithoutStatus · beginInteractiveScreen</div></div>
743
747
  <div class="mod"><div class="fname">runtime/bus-debug.ts</div><div class="fdesc">Dump diagnosis event bus (MINICODE_DEBUG_BUS=1): sekali per sesi agar event yatim pun terlihat; tanpa env = tanpa subscribe (zero-cost).</div><div class="exports">attachBusDebug</div></div>
744
- <div class="mod"><div class="fname">runtime/spinner.ts</div><div class="fdesc">Spinner wizard (glyphs.spinnerFrames); TTY-only — tanpa byte kontrol pada non-TTY; ikut arbitrase transient statusline.</div><div class="exports">createSpinner</div></div>
745
- <div class="mod"><div class="fname">footer.ts</div><div class="fdesc">Render footer status REPL (murni, tanpa IO): 1 baris status <code>✦ mode • model • cwd … 14.2k</code> (+ 1 baris kosong reserve saat lengket; tanpa garis separator). Mode pad-9 anti-geser (per kolom via padToWidth), satu-satunya berwarna; spark pulse saat busy / redup saat idle; konteks rata kanan; <code>sanitizeAnsi</code> + potong per kolom. Non-TTY diputuskan mekanisme, bukan di sini.</div><div class="exports">renderFooter · shortModel · paintFooterMode · FooterStatus</div></div>
746
- <div class="mod"><div class="fname">runtime/chrome.ts</div><div class="fdesc">Footer status LENGKET (satu-satunya chrome permanen): DECSTBM scroll-region 2 baris dasar (blank + status), output turn hanya di area atas — footer tak ikut scroll. Gaya <code>MINICODE_FOOTER=off|print|sticky|auto</code> (auto = lengket bila terminal mampu, cetak bila tidak; pipa non-TTY nol byte). <code>setBusy()</code> menggerakkan pulse spark redup→pulse; <code>Esc</code> lone-50ms saat turn = abort tanpa teks. Reset region dijamin di semua jalur keluar; fail-closed, tak pernah melempar (pola statusline).</div><div class="exports">createFooterChrome · footerReserveRows · FooterChrome · FooterMode</div></div>
748
+ <div class="mod"><div class="fname">runtime/spinner.ts</div><div class="fdesc">Spinner wizard (glyphs.spinnerFrames); TTY-only — tanpa byte kontrol pada non-TTY; ikut arbitrase transient statusline; opsi <code>delayMs</code>/<code>intervalMs</code> (anti-berkedip startup); diam total selama layar interaktif aktif (<code>beginInteractiveScreen</code>).</div><div class="exports">createSpinner</div></div>
749
+ <div class="mod"><div class="fname">footer.ts</div><div class="fdesc">Render status bar TUI (murni, tanpa IO): 1 baris status <code>✦ mode • model • cwd … 14.2k</code> (tanpa garis separator). Mode pad-9 anti-geser (per kolom via padToWidth), satu-satunya berwarna; spark pulse saat busy / redup saat idle; konteks rata kanan; <code>sanitizeAnsi</code> + potong per kolom.</div><div class="exports">renderFooter · shortModel · paintFooterMode · FooterStatus</div></div>
750
+ <div class="mod"><div class="fname">runtime/screen.ts</div><div class="fdesc">Pemilik alternate-screen (<code>?1049h/l</code>): enter/exit selalu berpasangan (refcount modal nested, idempoten), region di-reset unconditional, exit-handler sinkron sebagai jaring terakhir; <code>paintRegion</code> melukis popup TANPA clear di atas konten pemilik layar; null-screen fail-closed di non-TTY/<code>TERM=dumb</code>; setiap handle memegang hold <code>beginInteractiveScreen</code> (dilepas di <code>close()</code>) sehingga painter transient stderr diam selama layar hidup — termasuk wizard setup di atas spinner "Menyiapkan sesi…".</div><div class="exports">openAltScreen · AltScreen · altScreenDepth</div></div>
751
+ <div class="mod"><div class="fname">runtime/motion.ts</div><div class="fdesc">Preferensi gerak (MINICODE_MOTION): status busy tak boleh bergantung animasi — <code>MINICODE_MOTION=0</code> membekukan spark jadi glyph statis (aksesibilitas/rekaman/SSH lambat). Dibaca saat DIPAKAI (pola lazy seperti theme.ts).</div><div class="exports">motionReduced</div></div>
747
752
  <div class="mod"><div class="fname">input/prompt-engine.ts · input.ts</div><div class="fdesc">Engine input murni &amp; teruji: grapheme (Intl.Segmenter), state, dekode CSI/UTF-8 streaming, render spec; history (JSON per baris), askLine (+ onKey, multiline Ctrl+J, reverse-i-search Ctrl+R), askSecret; deletePrevUnit Thai/Lao-aware.</div><div class="exports">createState · applyKey · buildRenderSpec · decodeKeys · decodeKeysStream · toGraphemes · deletePrevUnit · MAX_VISIBLE · loadHistory · appendHistory · detectAnsi · askLine · askSecret</div></div>
748
- <div class="mod"><div class="fname">assistant/simple.ts · turn-status.ts</div><div class="fdesc">Printer linier (satu-satunya renderer, one-shot &amp; REPL): output append-only di scrollback; stdout = teks model/receipt, stderr = ledger tool &amp; diagnostik. Tool compact = satu baris <code>› nama target</code> (REPL default; env eksplisit menang; /compact / Ctrl+O membalik). Section besar (thinking/bash/edit/content) default minimize: satu baris <code>+ label</code>, isi di-buffer untuk /expand. Ledger SELALU ber-newline. Garis status turn lifecycle deterministik.</div><div class="exports">attachSimpleLogger · formatError · getLastTurnText · writeClipboardOsc52 · attachTurnStatus</div></div>
753
+ <div class="mod"><div class="fname">assistant/simple.ts · turn-status.ts</div><div class="fdesc">Printer linier (satu-satunya renderer, one-shot &amp; REPL): output append-only di scrollback; stdout = teks model/receipt, stderr = ledger tool &amp; diagnostik. Tool compact = satu baris <code>› nama target</code> (REPL default; env eksplisit menang; /compact / Ctrl+O membalik). Section besar (thinking/bash/edit/content) default minimize: satu baris <code>+ label</code>, isi di-buffer untuk /expand. Ledger SELALU ber-newline. Garis status turn lifecycle deterministik. Fase 6: dengan snapshot struktural dari cli/, status final/duration/receipt/retry ditambahkan pada ledger; jalur tulis, split stream, dan flag OFF tetap sama.</div><div class="exports">attachSimpleLogger · formatError · getLastTurnText · writeClipboardOsc52 · attachTurnStatus</div></div>
749
754
  <div class="mod"><div class="fname">approval/prompt.ts</div><div class="fdesc">View persetujuan tool call [y/a/n]; di-inject ke permission handler oleh cli/setup.ts; live-region screen reader saat MINICODE_A11Y=1.</div><div class="exports">promptAsk · ApprovalRequest</div></div>
750
- <div class="mod"><div class="fname">screens/overlay.ts</div><div class="fdesc">Primitive overlay transient bersama: redraw + clear delete-line yang konsisten untuk semua layar interaktif (tetap shell-like, tanpa panel permanen).</div><div class="exports">renderTransientOverlay · clearTransientOverlay</div></div>
751
- <div class="mod"><div class="fname">screens/picker.ts</div><div class="fdesc">Picker generik — dipakai manager &amp; wizard; transient, membersihkan diri sendiri; highlight substring query dengan bold.</div><div class="exports">runPicker</div></div>
752
- <div class="mod"><div class="fname">screens/wizard.ts · model-manager.ts · provider-manager.ts</div><div class="fdesc">View murni layar interaktif: hanya props data + callback async; tanpa akses config/disk. Model manager mengikuti pola overlay transient yang sama.</div><div class="exports">runSetupWizardView · runModelManagerView · runProviderManagerView</div></div>
755
+ <div class="mod"><div class="fname">screens/picker.ts</div><div class="fdesc">Picker generik popup — dipakai manager, wizard &amp; daftar sesi (/sessions); melukis HANYA region kotak via paintRegion di atas konten pemilik layar; highlight substring query dengan bold; setup gagal BERSUARA; layar tak mampu = tolak + batal.</div><div class="exports">runPicker</div></div>
756
+ <div class="mod"><div class="fname">screens/dialog.ts</div><div class="fdesc">Kotak dialog popup: border + judul opsional, TANPA bayangan; <code>dialogBox</code> (kotak saja untuk komposit paintRegion) + <code>dialogFrame</code> (selayar + backdrop <code>░</code> redup, hanya untuk layar ber-buffer sendiri); frame tepat <code>rows</code> dari geometri saat paint; murni tanpa IO; fallback ASCII.</div><div class="exports">dialogFrame · dialogBox</div></div>
757
+ <div class="mod"><div class="fname">screens/wizard.ts · model-manager.ts · provider-manager.ts</div><div class="fdesc">View layar interaktif: hanya props data + callback async; tanpa akses config/disk. Lebar kotak TETAP per permukaan (model 64, picker 64, provider 76); /model berjudul + hint footer (Del/type-to-filter discoverable), seleksi murni warna; nama/ID di depan label. SEMUA input lewat form dalam popup (add/edit/confirm) — tak ada askLine liar.</div><div class="exports">runSetupWizardView · runModelManagerView · runProviderManagerView</div></div>
758
+ <div class="mod"><div class="fname">screens/form.ts</div><div class="fdesc">Form generik dalam popup (lebar TETAP 64): text/secret (mask •)/select/confirm, Tab/↑↓ pindah, ←/→ pilih atau geser kursor, Enter validasi+submit (error merah inline), Esc DUA-TAHAP (tekan-1 bersihkan field, tekan-2 batal — isi tak hilang sekali tekan); kursor terminal diparkir di field aktif; region dibersihkan saat tutup; idle 90 dtk auto-batal.</div><div class="exports">runForm · validateRequired · validateUrl · FormSpec</div></div>
759
+ <div class="mod"><div class="fname">i18n/locale.ts · en.ts · id.ts</div><div class="fdesc">i18n nol-dependensi dwibahasa: kamus statis (id WAJIB kunci = en — tsc mengawal), <code>t(key, params)</code> interpolasi, fallback kunci hilang → en; prioritas /lang > MINICODE_LANG > state.json <code>lang</code> > locale OS > en; getter runtime (jangan beku ke const — aturan c/glyphs).</div><div class="exports">t · currentLocale · setSessionLocale · setConfigLocale · Locale · MsgKey</div></div>
760
+ <div class="mod"><div class="fname">approval/prompt.ts</div><div class="fdesc">Prompt persetujuan tool &amp; ask_user: blok pertanyaan + keputusan dicatat ke transkrip via approval sink (terlihat sebelum menjawab); tanpa sink = tulis langsung warisan; non-TTY = deny/null fail-closed.</div><div class="exports">promptAsk · promptAskText</div></div>
761
+ <div class="mod"><div class="fname">tui/transcript.ts</div><div class="fdesc">Kolektor transkrip TUI: event bus → baris LOGIS append-only (cap 5000, tertua dibuang); teks model sebagai ekor hidup sampai commit; ledger compact <code>› nama target</code> + error satu baris; thinking minimized = penanda, expanded = alir redup; view() wrap saat paint; approval sink (transkrip + repaint untuk prompt persetujuan). Snapshot/event struktural dari cli/, meta paralel, pinned running + elapsed, status final, retry/grup anak, ringkasan turn, marker evict, dan query /expand via ContentStore; renderer dan scroll tetap sama.</div><div class="exports">Transcript · TranscriptMeta · TranscriptOptions · TRANSCRIPT_CAP · setApprovalSink</div></div>
762
+ <div class="mod"><div class="fname">tui/app.ts</div><div class="fdesc">Pemilik tunggal layar: satu repaint sinkron per event, frame SELALU tepat <code>rows</code> (viewport + dropdown + input + status bar dari renderFooter); PgUp/PgDn scroll baris, Up/Down histori, Tab/Shift-Tab mode, Ctrl+O/T compact/thinking, Ctrl+D baris-kosong keluar; busy = input beku kecuali abort+scroll; cek ukuran sebelum enter (tanpa flicker); <code>suspend()/resume()</code> untuk popup komposit (lepas stdin + redupkan layar). Status snapshot dapat membawa activity presentasi terpin sebagai sumber data; mesin paint, coalesce, resize, dan cursor tidak diubah.</div><div class="exports">TuiApp · TuiHost · TuiStatusSnapshot · TuiRunResult</div></div>
753
763
  </div>
754
764
  </details>
755
765
 
756
766
  <details class="group" id="g-lain">
757
- <summary><span class="chip c2">L2</span> src/ lainnya <span class="role">— MCP, LSP, hooks, memory, skills, sandbox</span> <span class="cnt">12 modul</span></summary>
767
+ <summary><span class="chip c2">L2</span> src/ lainnya <span class="role">— MCP, LSP, hooks, memory, skills, sandbox, presentation</span> <span class="cnt">18 modul</span></summary>
758
768
  <div class="mods">
759
- <div class="mod"><div class="fname">mcp/ (client · server · transport · http-transport)</div><div class="fdesc">Klien &amp; server MCP; transport klien stdio/HTTP (SSRF-protected). server.ts = minicode jadi MCP server (stdio-only): validateArgs kernel + permission/jail + jurnal mutasi + idempotency per request-id + cancel per-request; tanpa turn/session kernel.</div><div class="exports">mcpInventory · extractMcpText · getMcpServerIds · McpServerConfig · serveMcp · selectTools</div></div>
769
+ <div class="mod"><div class="fname">presentation/events.ts</div><div class="fdesc">Kosakata semantik V2.1 (DomainEvent union 19 tipe, DURABILITY, hook ApprovalEventHook, ChildSessionLink parent-link forward anak) — SATU bahasa adaptor → reducer → proyeksi; renderer dilarang impor untuk keputusan semantik (hanya terima string final dari proyeksi Fase 3). ContentRef (toolCallId+idx+dead) = pointer konten besar ke ContentStore Fase 4.</div><div class="exports">DomainEvent · ToolIdentity · ArgsSummary · DenyReason · FailCause · CancelReason · ApprovalOutcome · TurnSummary · Receipt · ContentRef · ChildSessionLink · DURABILITY · EventBusLike · ApprovalEventHook · ApprovalHookEvent</div></div>
770
+ <div class="mod"><div class="fname">presentation/adapter.ts</div><div class="fdesc">Adaptor lama → DomainEvent (Fase 1–2, aditif + dual-subscribe): rekonstruksi tool.denied dari step.results, tool lifecycle dari execution:*, model/reasoning delta dari provider:*, approval dari hook DI (publishApproval), turn settle dari noteRunSettled (driver runOnce). Fase 2: assertExecutionShape (payload rusak → counter, bukan crash), registry child→parentCall (parentLink pada forward; paralel ambigu = orphan, jangan tebak). Fase 4: konten completed → ContentStore (put), noteFileChanged (jurnal committed → receipt). Jam &amp; eventSeq HANYA di sini; semua handler try/catch (observability tak boleh menggagalkan turn).</div><div class="exports">createPresentationAdapter · PresentationAdapter · AdapterDiagnostics · RunSettleInfo · parseQualifiedName · assertExecutionShape</div></div>
771
+ <div class="mod"><div class="fname">presentation/model.ts</div><div class="fdesc">Bentuk state presentasi (Activity/Turn/Approval/Conversation/Reasoning/System + PresentationState Map) + createInitialState/cloneState — murni tipe, tanpa logika; key Map = sessionId:turnId / sessionId:toolCallId (anak numbering sendiri).</div><div class="exports">PresentationState · ActivityEntry · TurnEntry · ApprovalEntry · ConversationEntry · ReasoningEntry · SystemEntry · EntryRef · ToolStatus · TurnStatus · createInitialState · cloneState · turnKey · activityKey</div></div>
772
+ <div class="mod"><div class="fname">presentation/reducer.ts</div><div class="fdesc">Satu-satunya penulis PresentationState (Fase 3, murni tanpa jam/IO/env): first-terminal-wins + counter diagnostik di luar state, force-close approval I-A08 saat turn settle, deriveSupersedes deterministik dari eventSeq (§10), rebuildFromDurable → interrupted/force-close saat crash. Shadow-run di setup.ts (hasil dibuang; divergensi = reduce melempar).</div><div class="exports">reduce · rebuildFromDurable · deriveSupersedes · createReducerDiagnostics · ReducerDiagnostics · createInitialState · cloneState</div></div>
773
+ <div class="mod"><div class="fname">presentation/label.ts</div><div class="fdesc">Labeler tunggal presentasi: targetOf/previewArgs/labelTool/statusLabel/summarizeResult + MAX_* cap — dipakai reducer (summary), predicate MCP, dan proyeksi; label UI legacy sudah delegates ke snapshot/label fallback.</div><div class="exports">targetOf · previewArgs · labelTool · statusLabel · summarizeResult · isMcpToolName · MAX_TARGET · MAX_PREVIEW · MAX_SUMMARY · MAX_LABEL · ToolLabel</div></div>
774
+ <div class="mod"><div class="fname">presentation/store.ts</div><div class="fdesc">Content Store sibling model (non-otoritatif I-A04): put/get/resolve/expand/expandAll dengan cap 200K per-entry + 500K total, FIFO evict + tandai dead (penanda retensi, bukan string kosong), durable fallback sqlite (output saja; reasoning di luar retensi = hilang jujur). Reducer TIDAK PERNAH baca store untuk keputusan.</div><div class="exports">createContentStore · ContentStore · ContentEntry · ContentMeta · ContentKind · MAX_SECTION_CHARS · MAX_BUFFER_TOTAL · contentKey</div></div>
775
+ <div class="mod"><div class="fname">mcp/client.ts · mcp/server.ts · mcp/transport.ts · mcp/http-transport.ts</div><div class="fdesc">Klien &amp; server MCP; transport klien stdio/HTTP (SSRF-protected). server.ts = minicode jadi MCP server (stdio-only): validateArgs kernel + permission/jail + jurnal mutasi + idempotency per request-id + cancel per-request; tanpa turn/session kernel.</div><div class="exports">mcpInventory · extractMcpText · getMcpServerIds · McpServerConfig · serveMcp · selectTools</div></div>
760
776
  <div class="mod"><div class="fname">lsp/client.ts</div><div class="fdesc">Klien LSP: diagnostics, posisi symbol, server per ekstensi.</div><div class="exports">LspConnection · configureServers · lspDiagnostics · languageIdFor</div></div>
761
777
  <div class="mod"><div class="fname">hooks/run.ts</div><div class="fdesc">Eksekusi hook eksternal opt-in (MINICODE_HOOKS=1). Env tersanitasi tanpa secret; dilewati bila sesi aborted. Allowlist pindah ke policy/allowlist.ts.</div><div class="exports">findRunHooks · runRunHooks</div></div>
762
778
  <div class="mod"><div class="fname">memory/files.ts · memory/vector.ts</div><div class="fdesc">Memori berbasis file &amp; pencarian vektor: FTS5 + idx lower(text), ranking MMR λ=0.7 + dedup cosine 0.92, chunk 2000/overlap 200 (kolom parent), TTL hierarkis fact/decision 180 + summary 90 + snippet 14 hari + cap 5000 baris, kolom model/dim/category/tags/access_count, SSRF strict. forget menghapus scope lokal + global (keduanya ikut di-search).</div><div class="exports">addMemory · searchHybrid · deleteMemoryByQuery · clearAllMemory · getMemoryStats · splitMemoryChunks · MemoryHit · MemoryStats</div></div>
@@ -766,7 +782,7 @@ footer.site .spacer { flex: 1; }
766
782
  <div class="mod"><div class="fname">agents/pool.ts</div><div class="fdesc">Pool sub-agen untuk tool task.</div></div>
767
783
  <div class="mod"><div class="fname">telemetry/trace.ts</div><div class="fdesc">Trace jsonl per request provider — bahan /stats &amp; gate telemetry; step-traces.jsonl per tool/step + klasifikasi deny + mode sandbox; catat memoryHits untuk hit-rate RAG (<code>memory status</code>).</div><div class="exports">RunTrace · StepTrace</div></div>
768
784
  <div class="mod"><div class="fname">config.ts · constants.ts</div><div class="fdesc">IO config murni: muat/simpan (global selalu; lokal hanya bila opt-in <code>--allow-local-config</code>, default fail-closed — lokal adalah input repo tak terpercaya) + CRUD MCP/LSP; LIMITS konstan pemotongan. Provisioning dipisah ke providers/provision.ts — arah satu arah: providers → config.</div><div class="exports">loadConfig · normalizeConfig · writeConfigAtomic · withConfigLock · localConfigPath · localConfigNotice · GLOBAL · LOCAL · saveMcpServer · removeMcpServer · saveLspServer · removeLspServer · MinicodeConfig · ProviderEntry · McpServerEntry · LspServerEntry · LIMITS</div></div>
769
- <div class="mod"><div class="fname">lib/atomic-write.ts · lib/db-path.ts · lib/net.ts · lib/trash.ts</div><div class="fdesc">Tulis atomik (tmp+rename); resolusi path database; penjaga SSRF bersama (host privat + DNS pinning) — dipakai web_fetch, web_search, dan transport MCP HTTP; soft-delete bersama ke .minicode/.trash (cap 100).</div><div class="exports">atomicWriteText · isPrivateHost · isPrivateHostWithDns · trashFile · trashDir</div></div>
785
+ <div class="mod"><div class="fname">lib/atomic-write.ts · lib/db-path.ts · lib/net.ts · lib/trash.ts · lib/ignore.ts · lib/keystore.ts · lib/session-id.ts</div><div class="fdesc">Tulis atomik (tmp+rename); resolusi path database; penjaga SSRF bersama (host privat + cek DNS ulang tanpa cache; residual check-then-connect didokumentasikan di web_fetch) — dipakai web_fetch, web_search, dan transport MCP HTTP; soft-delete bersama ke .minicode/.trash (cap 100); gitignore bersama; arsip kunci per-platform (DPAPI/keychain) + kunci spesifik test; id sesi aman-crash.</div><div class="exports">atomicWriteText · isPrivateHost · isPrivateHostWithDns · trashFile · trashDir · compileIgnoreMatchers · isIgnored · loadIgnoreMatchers · setSecret · getSecret · deleteSecret · keystoreBackend · sanitizeSessionPart</div></div>
770
786
  <div class="mod"><div class="fname">lib/safe-open.ts</div><div class="fdesc">Pemilik verifikasi path async, terbagi per kebutuhan: <code>resolveSafePath(p, root)</code> untuk tool PENULIS (butuh path real sebagai target tulis, toleran ENOENT untuk file baru); <code>safeOpenRead</code> (O_NOFOLLOW + cek jail &amp; sensitif pada titik open) untuk pembaca. Alur satu arah: tools → safe-open → jail; tanpa state global.</div><div class="exports">resolveSafePath · safeOpenRead · safeReadFile · safeStat · assertSafeWriteTarget</div></div>
771
787
  </div>
772
788
  </details>
@@ -909,7 +925,7 @@ export const kalkulatorTool: Tool = {
909
925
  <tr><td><code>MINICODE_SANDBOX_MEMORY</code></td><td>batas memori container (default <code>512m</code>)</td><td><code>src/sandbox/docker.ts</code></td></tr>
910
926
  <tr><td><code>MINICODE_SANDBOX_STRICT</code></td><td><code>1</code> → tak pernah fallback host (request eksplisit sudah fail-closed secara default)</td><td><code>src/policy/sandbox-policy.ts · src/tools/bash.ts</code></td></tr>
911
927
  <tr><td><code>MINICODE_SANDBOX_ALLOW_FALLBACK</code></td><td><code>1</code> → izinkan fallback host secara eksplisit bila backend tak tersedia</td><td><code>src/policy/sandbox-policy.ts · src/tools/bash.ts</code></td></tr>
912
- <tr><td><code>MINICODE_BUDGET_STRICT</code></td><td><code>1</code> → penegasan eksplisit fail-closed cost-tak-dikenal (kini juga default <code>--budget</code>)</td><td><code>cli/index.ts · cli/repl.ts · cli/commands/exec.ts</code></td></tr>
928
+ <tr><td><code>MINICODE_BUDGET_STRICT</code></td><td><code>1</code> → penegasan eksplisit fail-closed cost-tak-dikenal (kini juga default <code>--budget</code>)</td><td><code>cli/index.ts · cli/tui.ts · cli/setup.ts · cli/commands/exec.ts</code></td></tr>
913
929
  <tr><td><code>MINICODE_PROVIDER_ORDER</code></td><td>reorder provider, mis. <code>openai,anthropic,deepseek</code>, tanpa edit config</td><td><code>src/app/provider-layer.ts</code></td></tr>
914
930
  <tr><td><code>MINICODE_EMBED_MODEL</code></td><td>model embedding (default <code>text-embedding-3-small</code>)</td><td><code>src/memory/vector.ts</code></td></tr>
915
931
  <tr><td><code>MINICODE_GREP_ENGINE</code></td><td><code>js</code> → paksa engine JS, lewati ripgrep</td><td><code>src/tools/grep.ts</code></td></tr>
@@ -977,9 +993,9 @@ bun run bench # benchmark loop agen</pre></div>
977
993
  <li><b>Flag tak dikenal = kata prompt.</b> <code>cli/args.ts</code> hanya mengenali whitelist flag; <code>--typo</code> tidak error tetapi ikut masuk teks prompt (args.ts:62). Tambah flag baru = daftarkan di whitelist.</li>
978
994
  <li><b>Jail mendahului segala mode.</b> Tidak ada jalur eksekusi tool yang boleh mem-bypass <code>src/policy/jail.ts</code>, termasuk allow-all dan tool MCP.</li>
979
995
  <li><b>Tool tidak mengimpor lapisan app/sesi.</b> Kebutuhan lintas-lapisan (mis. sesi sub-agen untuk <code>delegate_task</code>) disuntikkan dari composition root via setter DI; tanpa injeksi tool fail-closed. Arah <code>providers → config</code> juga satu arah sejak provisioning dipisah ke <code>providers/provision.ts</code>.</li>
980
- <li><b>Output shell-first.</b> Tidak ada alternate screen (?1049h), tidak ada redraw penuh, tidak ada modal overlay: output mengalir append-only ke scrollback dan scrollback adalah satu-satunya transcript. Tool call compact di REPL (satu baris <code>› nama target</code>); section besar default minimize (<code>+ label</code>, dibuka via + / - atau /expand); expanded tersedia via env/<code>/compact</code>/verbose. UI ekran (manager/wizard/picker) transient — menghapus diri sendiri, tidak menyentuh scrollback.</li>
981
- <li><b>Kontrak terminal FROZEN.</b> <code>docs/TERMINAL_CONTRACT.md</code> membekukan klasifikasi writer, contract stdout/stderr, dan 14 invariant terminal (§9) — wajib dibaca sebelum menyentuh output/rendering; setiap perubahan perilaku wajib update dokumen + test peta proteksinya.</li>
982
- <li><b>Satu arbitrase transient.</b> Semua painter stderr (garis turn, wizard spinner) lewat <code>acquireTransientPaint</code>/<code>paintWrite</code> di <code>src/ui/runtime/statusline.ts</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen — tidak hilang, tidak merusak transient.</li>
996
+ <li><b>Satu tampilan: TUI fullscreen.</b> Transkrip ala shell + status bar + popup komposit (/model, /provider, /sessions) di atas transkrip yang tetap terlihat (redup). Alternate screen HANYA lewat <code>src/ui/runtime/screen.ts</code> (enter/exit berpasangan + <code>paintRegion</code> tanpa clear); non-TTY/one-shot/layar kecil = tolak bersuara + batal. Tool call compact (satu baris <code>› nama target</code>). Dropdown <code>/</code> berbingkai dan terhapus di semua jalur keluar. REPL linier, footer lengket, overlay inline, jendela info: DIHAPUS.</li>
997
+ <li><b>Kontrak terminal TUI.</b> <code>docs/TERMINAL_CONTRACT.md</code> (v6 TUI fullscreen 2026-09-22) membekukan klasifikasi writer, contract stdout/stderr, komposit popup, dan 30 invariant terminal (I1–I30) — wajib dibaca sebelum menyentuh output/rendering; setiap perubahan perilaku wajib update dokumen + test peta proteksinya.</li>
998
+ <li><b>Satu arbitrase transient + satu lifecycle modal.</b> Semua painter stderr (garis turn, wizard spinner) lewat <code>acquireTransientPaint</code>/<code>paintWrite</code> di <code>src/ui/runtime/statusline.ts</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen — tidak hilang, tidak merusak transient. Semua modal lewat <code>openAltScreen</code>/<code>close</code> di <code>src/ui/runtime/screen.ts</code>; layar interaktif apa pun (popup/alt-screen/raw prompt) menahan painter transient via <code>beginInteractiveScreen</code> — spinner setup tak pernah menimpa prompt wizard.</li>
983
999
  <li><b>Non-TTY = polos.</b> Pipe/redirect/CI tidak boleh mengandung cursor control, animasi, atau warna (warna digate <code>stdout.isTTY</code>; NO_COLOR menang).</li>
984
1000
  <li><b>Peta ini harus hidup.</b> Setiap perubahan struktur (tambah/hapus/pindah modul atau lapisan) WAJIB memperbarui <code>docs/ARCHITECTURE.html</code> dalam perubahan yang sama — lihat AGENTS.md.</li>
985
1001
  </ul>
@@ -988,7 +1004,7 @@ bun run bench # benchmark loop agen</pre></div>
988
1004
  <!-- ── 9 · UI/UX UNTUK DEVELOPER ── -->
989
1005
  <section id="ux">
990
1006
  <h2 class="sec"><span class="hn">09</span> UI/UX untuk developer — rendering terminal <a class="anchor" href="#ux">#</a></h2>
991
- <p class="lede">Ringkasan kontrak output yang menjaga MiniCode tetap shell-native: lima primitif tampilan, dua stream dengan peran tetap, satu arbitrase transient. Versi lengkap + residual risk yang disengaja ada di <code>docs/TERMINAL_CONTRACT.md</code> (FROZEN); panduan pengguna di <code>docs/USAGE.md</code>.</p>
1007
+ <p class="lede">Ringkasan kontrak TUI fullscreen minicode: transkrip + status bar + popup komposit. Versi lengkap + residual risk yang disengaja ada di <code>docs/TERMINAL_CONTRACT.md</code> (v6 TUI fullscreen 2026-09-22); panduan pengguna di <code>docs/USAGE.md</code>.</p>
992
1008
 
993
1009
  <div class="uxgrid">
994
1010
  <div class="uxcard"><h4>1 · Prompt</h4><p><code>minicode &lt;mode&gt; ›</code> — baris input interaktif + dropdown slash; satu-satunya elemen “hidup” saat idle.</p></div>
@@ -1010,11 +1026,11 @@ bun run bench # benchmark loop agen</pre></div>
1010
1026
  <div class="tscroll" style="margin-top:16px">
1011
1027
  <table>
1012
1028
  <tr><th>#</th><th>Invariant (ringkas)</th><th>Dijaga oleh test</th></tr>
1013
- <tr><td>1</td><td>Shell-native CLI — bukan TUI (tanpa alternate screen/panel)</td><td><code>ui-boundary</code></td></tr>
1029
+ <tr><td>1</td><td>Satu tampilan interaktif: TUI fullscreen; frame penuh tepat rows</td><td><code>ui-boundary</code>, <code>screen</code>, <code>tui-app</code></td></tr>
1014
1030
  <tr><td>2</td><td>Contract stdout/stderr jelas (TTY &amp; non-TTY deterministic)</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
1015
- <tr><td>3</td><td>Transient rendering satu ownership mechanism</td><td><code>terminal-contract</code>, <code>transient-arbitration</code></td></tr>
1031
+ <tr><td>3</td><td>Transient satu ownership + modal satu lifecycle</td><td><code>terminal-contract</code>, <code>transient-arbitration</code>, <code>screen</code></td></tr>
1016
1032
  <tr><td>4</td><td>Scrollback permanen tidak bergantung pada transient painter</td><td><code>transient-arbitration</code></td></tr>
1017
- <tr><td>5</td><td>Tanpa transient stale: success/failure/cancel/SIGINT/retry/detach/session-end</td><td><code>turn-status</code>, <code>terminal-contract</code>, <code>repl-linear</code></td></tr>
1033
+ <tr><td>5</td><td>Tanpa popup yatim / input bocor: success/failure/cancel/SIGINT/session-end</td><td><code>turn-status</code>, <code>terminal-contract</code>, <code>tui-app</code></td></tr>
1018
1034
  <tr><td>6</td><td>Non-TTY: 0 cursor control / animasi / ANSI tak diperlukan</td><td><code>transient-arbitration</code>, <code>theme</code></td></tr>
1019
1035
  <tr><td>7</td><td>Tool activity default compact, tanpa bocor isi ke ledger</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
1020
1036
  <tr><td>8</td><td>Streaming tanpa duplicate/overlap/stale spinner-status</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
@@ -1022,8 +1038,18 @@ bun run bench # benchmark loop agen</pre></div>
1022
1038
  <tr><td>10</td><td>Painter &amp; spinner mutually exclusive (signal overlap)</td><td><code>transient-arbitration</code>, <code>terminal-contract</code></td></tr>
1023
1039
  <tr><td>11</td><td>Resize memakai lebar saat paint (bukan lebar lama)</td><td><code>turn-status</code></td></tr>
1024
1040
  <tr><td>12</td><td>Long session tetap readable (ledger satu baris per tool)</td><td><code>terminal-contract</code></td></tr>
1025
- <tr><td>13</td><td>Footer lengket satu-satunya chrome permanen (sticky 2 baris, reset region di semua jalur keluar, non-TTY nol byte)</td><td><code>footer-render</code>, <code>footer-chrome</code></td></tr>
1026
- <tr><td>14</td><td>Idle binding: Esc/Ctrl+C/Ctrl+D resolve null; Ctrl+C 1x = copy, 2x = keluar; abort turn via lone Esc/Ctrl+C</td><td><code>repl-linear</code>, <code>terminal-contract</code></td></tr>
1041
+ <tr><td>13</td><td>Status bar 1 baris dasar (mode • model • cwd … ctx); spark pulse saat busy</td><td><code>footer-render</code>, <code>tui-app</code></td></tr>
1042
+ <tr><td>14</td><td>Binding TUI: PgUp/PgDn scroll, Up/Down histori, Tab/Shift+Tab mode, Ctrl+D baris-kosong keluar; busy = input beku total kecuali abort+scroll; placeholder + indikator baris baru</td><td><code>tui-app</code>, <code>terminal-contract</code></td></tr>
1043
+ <tr><td>15</td><td>(Dihapus bersama jendela info — /status &amp; /history = readout transkrip)</td><td><code>cli-commands</code></td></tr>
1044
+ <tr><td>16</td><td>Popup komposit: region tanpa clear + union-clear anti-hantu + clearRegion + suspend/resume; layar tak mampu = tolak bersuara + batal</td><td><code>screen</code>, <code>dialog</code>, <code>tui-app</code>, <code>tui-popup</code></td></tr>
1045
+ <tr><td>17</td><td>TUI fullscreen: App satu-satunya penulis layar + repaint live bus; frame penuh tepat rows; scrollback utama tak tersentuh</td><td><code>tui-app</code>, <code>screen-buffer</code></td></tr>
1046
+ <tr><td>18</td><td>Transkrip append-only + PgUp/PgDn scroll, Up/Down histori, ketikan baru kembali ke ekor</td><td><code>tui-app</code>, <code>tui-transcript</code></td></tr>
1047
+ <tr><td>19</td><td>Prompt TUI multiline + Tab/Shift-Tab/Ctrl+O/T/R seperti REPL; Ctrl+D baris-kosong keluar; histori memori-sesi</td><td><code>tui-app</code>, <code>prompt-engine</code></td></tr>
1048
+ <tr><td>20</td><td>Status bar 1 baris dari sumber yang sama dengan footer; spark pulse saat busy</td><td><code>tui-app</code>, <code>footer-render</code></td></tr>
1049
+ <tr><td>21</td><td>Form dalam popup: input di dalam kotak + validasi + kursor diparkir</td><td><code>form</code>, <code>tui-popup</code></td></tr>
1050
+ <tr><td>22</td><td>Thinking terlihat + commit fase; buffer /expand sekali ambil</td><td><code>tui-transcript</code></td></tr>
1051
+ <tr><td>23</td><td>Approval &amp; ask_user tercatat + terlihat sebelum menjawab</td><td><code>approval-tui</code></td></tr>
1052
+ <tr><td>24</td><td>/expand hidup; persist /model; /help ringkas</td><td><code>tui-transcript</code>, <code>cli-commands</code></td></tr>
1027
1053
  </table>
1028
1054
  </div>
1029
1055
 
@@ -1039,7 +1065,7 @@ bun run bench # benchmark loop agen</pre></div>
1039
1065
  <footer class="site">
1040
1066
  <span>Minicode · Peta struktur hidup — terminal contract FROZEN (<a href="TERMINAL_CONTRACT.md">docs/TERMINAL_CONTRACT.md</a>)</span>
1041
1067
  <span class="spacer"></span>
1042
- <span>v0.9.28 · diperbarui 2026-09-18</span>
1068
+ <span>v0.11.0 · diperbarui 2026-09-24</span>
1043
1069
  </footer>
1044
1070
 
1045
1071
  </div>
@@ -0,0 +1,139 @@
1
+ # Control Plane Map — kontrak context/usage/cost/budget/compaction/termination
2
+
3
+ Dokumen ini membekukan kontrak control-plane MiniCode (Phase 6, 2026-09-17).
4
+ Tujuannya: satu sumber kebenaran per konsep, hubungan antar-konsep eksplisit,
5
+ dan setiap keputusan (kompaksi, abort, termination) dapat dijelaskan.
6
+
7
+ Prinsip: **Context ≠ Cost. Cost ≠ Usage. Usage ≠ Budget. Budget ≠ Termination.
8
+ Compaction ≠ Retry. Tool cap ≠ Context cap.** — semua konsep berbeda dan
9
+ punya owner sendiri; yang disatukan di sini hanya *hubungannya*.
10
+
11
+ ## 1. Empat angka konteks (dua konsep, dua ukuran)
12
+
13
+ | Konsep | Ukuran | Owner | Sumber kebenaran | Dipakai |
14
+ |---|---|---|---|---|
15
+ | Logical context | token ESTIMASI (chars/4, sadar-gambar) | Kernel loop + `Session.contextTokens` | `estimateSessionContext` (`vendor tokens.ts`) — messages+system+tools | pressure evaluation, footer, `/status` |
16
+ | Serialized context | chars wire (JSON/base64 +overhead) | Adapter provider | `buildRequest` per adapter | dikirim, tidak diukur tersendiri |
17
+ | Provider usage | token yang dilaporkan provider | `createUsageCollector` | event `provider:extension{kind:"usage"}` — **boleh hilang** | akumulasi turn/session, cost |
18
+ | Economic usage | USD estimated dari harga tabel | `costFor`/`findPrice` | harga × usage; `undefined` = unknown | `--budget`, `/status` |
19
+
20
+ Relationship eksplisit:
21
+ - `logical` ≠ `serialized` (JSON overhead, base64 +33% — konsisten undercount).
22
+ - `provider usage` boleh tak ada → **unknown tetap unknown, bukan zero**
23
+ (collector tidak pernah memalsukan angka).
24
+ - `economic` selalu estimasi (tabel harga basi/stale) — bukan tagihan riil.
25
+
26
+ ## 2. Owner map (siapa tahu / siapa memutuskan)
27
+
28
+ | Konsep | TAHU | MEMUTUSKAN |
29
+ |---|---|---|
30
+ | Context size | Kernel loop (`contextTokens`) + `Session.contextTokens` getter (ekspos ke driver/UI) | Kernel: kompaksi + gagal-bila-critical |
31
+ | Compaction | Kernel (pressure + flag) | Kernel: KAPAN + fallback; LLM: ISI ringkasan |
32
+ | Termination | maxSteps/timeout (kernel), budget (driver), abort (user) | Kernel: maxSteps, timeout, post-kompaksi critical; Driver: budget abort; User: Ctrl+C/Esc |
33
+ | Budget | Collector (usage live) + `budgetStatus` | `budgetStatus` (terpusat, seragam REPL/one-shot/exec) + watcher abort |
34
+ | Backpressure | Producer caps + kernel truncate | Cap di producer (sudah benar); kernel truncate terakhir |
35
+
36
+ ## 3. Compaction Contract (Phase 6 — seam kernel)
37
+
38
+ **Dua semantics terpisah, tidak lagi satu flag:**
39
+
40
+ - `compactedForBudget` — kompaksi budget-pressure (`shouldCompact(pressure)`).
41
+ Set saat dicoba (anti berulang tiap step O(n)). Kritis setelahnya →
42
+ `AgentError("budget_exceeded")` (bukan retry provider sia-sia).
43
+ - `compactedForRecovery` — kompaksi recovery (`force_compact_and_retry` /
44
+ `onLength`). Set SETELAH compact (anti loop abadi: jalur ini tidak dihitung
45
+ `maxProviderRetries`). Kedua kalinya → `budget_exceeded`.
46
+
47
+ **Reason event** (`context:compacted`, `reason` — nama generik kernel,
48
+ diselaraskan 0.9.27 saat seam dihilirkan; sebelumnya `budget:<…>`):
49
+ - `pressure:<pressure>` — kompaksi policy-path yang benar-benar mengurangi messages.
50
+ - `pressure:<pressure>:no-op` — kompaksi policy-path yang TIDAK mengurangi (tidak ada
51
+ yang bisa dibuang dari messages — operator harus tahu bedanya dari fixed
52
+ overhead: system+tool schema, yang tidak pernah terkompaksi).
53
+ - `recovery` — kompaksi dari recovery (`context_length_exceeded` / `length`).
54
+
55
+ **Contract wajib menjawab:**
56
+ - *Who requested?* — budget path (kernel, pressure ≥ 75%) atau recovery path
57
+ (kernel, error konteks). Manual `/compact` tak menyentuh kernel (view saja).
58
+ - *Why?* — reason event di atas.
59
+ - *What is eligible?* — hanya messages; system prompt di-cap di hulu
60
+ (`SYSTEM_PROMPT_MAX_CHARS` 8000), tool schema TIDAK pernah terkompaksi.
61
+ - *What must be preserved?* — pasangan assistant(toolCalls)→tool results tidak
62
+ pernah dipecah (`compact.ts`); summary LLM terpin verbatim (anti-drift).
63
+ - *What may be removed?* — hasil tool sukses (ditinggal `<result omitted>` di
64
+ mechanical; LLM menulis ringkasan fakta), reasoning, tail lama.
65
+ - *What if compaction fails?* — LLM gagal/timeout (10s) → fallback sync
66
+ mekanis; async compactor tak pernah bisa crash loop.
67
+ - *Can it retry?* — budget: tidak (flag); recovery: sekali per turn (flag).
68
+ - *Can another occur in the same turn?* — budget + recovery boleh co-exist
69
+ (flag terpisah); sesama kind tidak.
70
+ - *What does compaction itself consume?* — LLM kompaksi berbiaya; usage-nya
71
+ ditangkap `compactWithLlm` → callback `onUsage` → bus sesi (event usage
72
+ standar) — **bukan blind spot lagi** (Phase 6, E5).
73
+
74
+ ## 4. Budget Contract
75
+
76
+ Status (`budgetStatus`, terpusat): `ok | over | unknown-strict`.
77
+
78
+ | Fase | Semantics |
79
+ |---|---|
80
+ | Preflight (prompt baru) | `tokens == 0` (belum ada pemakaian tercatat) → **start selalu boleh** (lockout strict tidak diminta — Phase 5 E-3c); `tokens > 0` + cost unknown → ditolak (fail-closed, F-06); cost known + over → ditolak |
81
+ | In-flight | `watchBudgetLimit` membaca biaya LIVE per usage event; fire-once → `ctl.abort(budgetExceededError())` — kind `budget_exceeded` dipertahankan (terbedakan dari abort user) |
82
+ | Post-usage | cost = estimated dari harga tabel (bukan tagihan riil); cost unknown → status `unknown-strict`, angka palsu tidak dibuat |
83
+
84
+ **Context vs budget adalah dua dimensi independen**: pressure HIGH + cost LOW
85
+ valid (tool result raksasa, model gratis); pressure LOW + cost HIGH valid
86
+ (konteks kecil, model mahal). Tidak ada asumsi `high context = high cost`.
87
+
88
+ ## 5. Termination Contract
89
+
90
+ | Reason | Owner | Mekanisme |
91
+ |---|---|---|
92
+ | `completed` | kernel loop | tidak ada tool call → `finalText` |
93
+ | `max_steps_exceeded` | kernel loop | `stepIndex >= maxSteps` |
94
+ | `timeout` | kernel `createTimeout` | `AgentError("timeout")` — dipertahankan |
95
+ | `budget_exceeded` | kernel (post-kompaksi) / driver (watcher abort) | `AgentError("budget_exceeded")` — dipertahankan |
96
+ | `aborted` | user (Ctrl+C/Esc) / `session.abort()` | sinyal tanpa kind AgentError |
97
+ | `provider` | kernel loop | provider error setelah retry habis |
98
+ | busy | kernel | `run()` saat `running` |
99
+
100
+ Satu terminal reason per sinyal (`abortError` mempertahankan kind
101
+ `AgentError`); pemutus lain dapat REQUEST, tidak ada competing owners —
102
+ `joinSignals` + `withAbort` = satu titik settle.
103
+
104
+ ## 6. Producer/Backpressure hierarchy
105
+
106
+ ```
107
+ producer-side cap (bash 20k, git 500k, mcp 100k, read_file paging, ...)
108
+ ↓
109
+ kernel truncate (toolResultMaxTokens 4096 tok = 16.384 chars, head 70%+tail 30%)
110
+ ↓
111
+ context insertion (store append — cap by truncation di atas)
112
+ ↓
113
+ compaction (messages; system/schema = fixed overhead, tidak pernah terkompaksi)
114
+ ↓
115
+ termination (budget_exceeded bila critical setelah kompaksi)
116
+ ```
117
+
118
+ Aturan: **jangan double-truncate tanpa semantics** — raw output cap ≠ context
119
+ insertion cap ≠ stored result cap ≠ display cap. Keempatnya boleh berbeda,
120
+ tetapi setiap lapisan harus tahu apa yang hilang di situ (marker truncation
121
+ wajib). Guard `read_image` memakai angka kernel (16.184 chars) — bukan angka
122
+ sendiri (bug E-1 sudah ditutup).
123
+
124
+ ## 7. Observability contract
125
+
126
+ Operator harus bisa membedakan (tanpa ambigu):
127
+ - `/status`: `Context` (window estimate, kernel) vs `Input/Output/Total`
128
+ (provider usage) vs `Cost` (estimated) vs `Budget` (status keputusan).
129
+ - Footer: angka = ukuran jendela saat ini (kernel) — bukan spend kumulatif.
130
+ - `context:compacted` event: reason membedakan policy-pressure/recovery/no-op.
131
+
132
+ ## Proteksi (test → kontrak)
133
+
134
+ - `test/control-plane.test.ts` — compaction budget≠recovery (F-10), anti-loop,
135
+ contextTokens getter + konsistensi estimator, termination reason.
136
+ - `test/cli-help-language.test.ts` — /status membedakan Context/Usage/Budget.
137
+ - `test/repl-linear.test.ts` — footer membaca kernel contextTokens.
138
+ - `test/usage-session.test.ts` / `budget-unknown.test.ts` — budget contract.
139
+ - `test/pack-integrity.test.ts` — vendor hash + VENDOR.md sinkron.