minicode-ai 0.10.0 → 0.11.1

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 (129) hide show
  1. package/AGENTS.md +45 -0
  2. package/CHANGELOG.md +68 -4
  3. package/PLAN.md +491 -0
  4. package/README.md +2 -2
  5. package/cli/commands/acp.ts +485 -0
  6. package/cli/commands/auth.ts +7 -4
  7. package/cli/commands/config.ts +41 -27
  8. package/cli/commands/exec.ts +33 -12
  9. package/cli/commands/mcp.ts +3 -2
  10. package/cli/commands/memory.ts +1 -1
  11. package/cli/commands/pricing.ts +6 -4
  12. package/cli/commands/providers.ts +18 -8
  13. package/cli/commands/sessions.ts +11 -4
  14. package/cli/commands/skills.ts +3 -3
  15. package/cli/commands/stats.ts +3 -1
  16. package/cli/commands.ts +6 -0
  17. package/cli/index.ts +82 -57
  18. package/cli/model-manager.ts +6 -1
  19. package/cli/router.ts +7 -0
  20. package/cli/setup.ts +341 -5
  21. package/cli/tui.ts +54 -18
  22. package/docs/ARCHITECTURE.html +32 -25
  23. package/docs/CONTROL-PLANE-MAP.md +139 -0
  24. package/docs/HARNESS.md +150 -0
  25. package/docs/PLAN_UIUX_V6.md +209 -0
  26. package/docs/README.md +1 -1
  27. package/docs/SUMMARY.md +52 -0
  28. package/docs/TERMINAL_CONTRACT.md +372 -0
  29. package/docs/UI_RENDER_PIPELINE.md +169 -0
  30. package/docs/USAGE.md +11 -0
  31. package/docs/agents.md +31 -0
  32. package/docs/architecture.md +3 -3
  33. package/docs/choosing-mode.md +34 -0
  34. package/docs/cli.md +130 -0
  35. package/docs/concepts.md +53 -0
  36. package/docs/config-providers.md +87 -0
  37. package/docs/config.md +63 -0
  38. package/docs/contributing.md +79 -0
  39. package/docs/environment.md +95 -0
  40. package/docs/exec.md +73 -0
  41. package/docs/getting-started.md +102 -0
  42. package/docs/glossary.md +37 -0
  43. package/docs/mcp-lsp.md +54 -0
  44. package/docs/memory-sessions.md +63 -0
  45. package/docs/policy-sandbox.md +72 -0
  46. package/docs/pricing-budget.md +49 -0
  47. package/docs/quickstart.md +60 -0
  48. package/docs/repl.md +67 -0
  49. package/docs/security-model.md +95 -0
  50. package/docs/security.md +91 -0
  51. package/docs/skills.md +48 -0
  52. package/docs/terminal.md +79 -0
  53. package/docs/tools.md +123 -0
  54. package/docs/troubleshooting.md +40 -0
  55. package/docs/verify-benchmark.md +58 -0
  56. package/package.json +8 -5
  57. package/src/app/provider-layer.ts +12 -4
  58. package/src/app/session.ts +6 -0
  59. package/src/app/tool-layer.ts +2 -1
  60. package/src/constants.ts +35 -0
  61. package/src/lib/net.ts +6 -1
  62. package/src/lsp/client.ts +41 -8
  63. package/src/mcp/http-transport.ts +52 -15
  64. package/src/mcp/transport.ts +32 -1
  65. package/src/memory/files.ts +6 -5
  66. package/src/policy/allowlist.ts +1 -1
  67. package/src/policy/bash-guard.ts +154 -14
  68. package/src/policy/compaction.ts +57 -3
  69. package/src/policy/context.ts +4 -0
  70. package/src/policy/jail.ts +49 -4
  71. package/src/policy/permission.ts +152 -12
  72. package/src/policy/pricing.ts +12 -9
  73. package/src/presentation/adapter.ts +721 -0
  74. package/src/presentation/events.ts +324 -0
  75. package/src/presentation/label.ts +140 -0
  76. package/src/presentation/model.ts +172 -0
  77. package/src/presentation/reducer.ts +486 -0
  78. package/src/presentation/store.ts +256 -0
  79. package/src/providers/anthropic.ts +22 -4
  80. package/src/providers/detect.ts +2 -1
  81. package/src/providers/responses.ts +15 -5
  82. package/src/providers/router.ts +13 -0
  83. package/src/repo/repomap.ts +2 -29
  84. package/src/session/checkpoint.ts +27 -9
  85. package/src/session/journal.ts +27 -5
  86. package/src/skills/loader.ts +88 -5
  87. package/src/telemetry/trace.ts +36 -15
  88. package/src/tools/ask_user.ts +73 -4
  89. package/src/tools/bash.ts +15 -17
  90. package/src/tools/glob.ts +10 -11
  91. package/src/tools/lsp.ts +3 -56
  92. package/src/tools/memory.ts +13 -12
  93. package/src/tools/task.ts +1 -0
  94. package/src/ui/approval/prompt.ts +14 -6
  95. package/src/ui/assistant/simple.ts +137 -26
  96. package/src/ui/assistant/turn-status.ts +16 -3
  97. package/src/ui/contract.ts +119 -0
  98. package/src/ui/footer.ts +27 -5
  99. package/src/ui/i18n/en.ts +38 -6
  100. package/src/ui/i18n/id.ts +38 -6
  101. package/src/ui/i18n/locale.ts +3 -1
  102. package/src/ui/input/input.ts +51 -4
  103. package/src/ui/input/prompt-engine.ts +46 -4
  104. package/src/ui/render/collapse.ts +13 -13
  105. package/src/ui/render/diff.ts +7 -2
  106. package/src/ui/render/format.ts +16 -8
  107. package/src/ui/render/highlight.ts +7 -3
  108. package/src/ui/render/markdown.ts +5 -1
  109. package/src/ui/render/sanitize.ts +29 -2
  110. package/src/ui/render/table.ts +8 -5
  111. package/src/ui/render/theme.ts +18 -4
  112. package/src/ui/render/width.ts +89 -10
  113. package/src/ui/runtime/motion.ts +16 -0
  114. package/src/ui/runtime/screen.ts +45 -0
  115. package/src/ui/runtime/spinner.ts +50 -4
  116. package/src/ui/runtime/statusline.ts +50 -1
  117. package/src/ui/screens/form.ts +42 -15
  118. package/src/ui/screens/model-manager.ts +26 -18
  119. package/src/ui/screens/picker.ts +47 -23
  120. package/src/ui/screens/provider-manager.ts +18 -12
  121. package/src/ui/screens/wizard.ts +24 -8
  122. package/src/ui/tui/app.ts +376 -43
  123. package/src/ui/tui/transcript.ts +269 -65
  124. package/vendor/minicore/LICENSE +21 -0
  125. package/vendor/minicore/VENDOR.md +6 -3
  126. package/vendor/minicore/package.json +6 -3
  127. package/vendor/minicore/src/core/loop.ts +12 -2
  128. package/vendor/minicore/src/core/snapshot.ts +4 -0
  129. package/vendor/minicore/src/providers/openai-compat.ts +76 -25
@@ -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.10.0 · Bun-only · 0 deps</span>
467
+ <span class="vpill hide-m">v0.11.1 · 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>
@@ -655,7 +655,7 @@ footer.site .spacer { flex: 1; }
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
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
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/ — 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>
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>
@@ -733,23 +733,24 @@ footer.site .spacer { flex: 1; }
733
733
  </details>
734
734
 
735
735
  <details class="group" id="g-ui">
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">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>
737
737
  <div class="mods">
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.</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>
739
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>
740
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>
741
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>
742
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>
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 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>
744
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>
745
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>
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.</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>
747
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>
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.</div><div class="exports">createSpinner</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
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>.</div><div class="exports">openAltScreen · AltScreen · altScreenDepth</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>
751
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>
752
- <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>
753
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>
754
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>
755
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,15 +758,21 @@ footer.site .spacer { flex: 1; }
757
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>
758
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>
759
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>
760
- <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 (penanda minimized + buffer /expand, alir redup expanded); buffer section /expand (sekali ambil habis); view() wrap saat paint; approval sink (transkrip + repaint untuk prompt persetujuan).</div><div class="exports">Transcript · TRANSCRIPT_CAP · setApprovalSink</div></div>
761
- <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).</div><div class="exports">TuiApp · TuiHost · TuiStatusSnapshot · TuiRunResult</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>
762
763
  </div>
763
764
  </details>
764
765
 
765
766
  <details class="group" id="g-lain">
766
- <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>
767
768
  <div class="mods">
768
- <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>
769
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>
770
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>
771
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>
@@ -775,7 +782,7 @@ footer.site .spacer { flex: 1; }
775
782
  <div class="mod"><div class="fname">agents/pool.ts</div><div class="fdesc">Pool sub-agen untuk tool task.</div></div>
776
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>
777
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>
778
- <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>
779
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>
780
787
  </div>
781
788
  </details>
@@ -918,7 +925,7 @@ export const kalkulatorTool: Tool = {
918
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>
919
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>
920
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>
921
- <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>
922
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>
923
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>
924
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>
@@ -987,8 +994,8 @@ bun run bench # benchmark loop agen</pre></div>
987
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>
988
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>
989
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>
990
- <li><b>Kontrak terminal TUI.</b> <code>docs/TERMINAL_CONTRACT.md</code> (v4 single-TUI 2026-09-21) membekukan klasifikasi writer, contract stdout/stderr, komposit popup, dan 20 invariant terminal (§9) — wajib dibaca sebelum menyentuh output/rendering; setiap perubahan perilaku wajib update dokumen + test peta proteksinya.</li>
991
- <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>.</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>
992
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>
993
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>
994
1001
  </ul>
@@ -997,12 +1004,12 @@ bun run bench # benchmark loop agen</pre></div>
997
1004
  <!-- ── 9 · UI/UX UNTUK DEVELOPER ── -->
998
1005
  <section id="ux">
999
1006
  <h2 class="sec"><span class="hn">09</span> UI/UX untuk developer — rendering terminal <a class="anchor" href="#ux">#</a></h2>
1000
- <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> (v4 single-TUI 2026-09-21); 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>
1001
1008
 
1002
1009
  <div class="uxgrid">
1003
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>
1004
1011
  <div class="uxcard"><h4>2 · Pesan model</h4><p>Streaming ke <b>stdout</b>, di-sanitasi, dibungkus per baris mengikuti kolom terminal; fence markdown indent 2 spasi.</p></div>
1005
- <div class="uxcard"><h4>3 · Aktivitas</h4><p>Garis transient di <b>stderr</b> (TTY saja): <code>✦···</code> kelip putih↔abu saat thinking, atau <code>frame label···</code> selama tool berjalan. Hilang saat teks mengalir.</p></div>
1012
+ <div class="uxcard"><h4>3 · Aktivitas</h4><p>Status bar fullscreen memiliki clock sendiri: <code>Working</code> selama turn hidup, <code>Thinking</code> hanya saat reasoning nyata, dan <code>Running tool target</code> selama tool. Elapsed dan pulse menjadi milik App, bukan event provider; <code>MINICODE_MOTION=0</code> mematikan pulse tetapi mempertahankan teks status.</p></div>
1006
1013
  <div class="uxcard"><h4>4 · Hasil tool</h4><p>Ledger stderr, compact: <code>› nama target</code> satu baris (hijau; tanpa bocor isi file); error <code>› nama: pesan</code> (merah). Section besar default minimize (<code>+ label</code>); expanded/verbose menampilkan isi.</p></div>
1007
1014
  <div class="uxcard"><h4>5 · Error</h4><p><code>✗ pesan actionable</code> — sekali per kegagalan via <code>takePendingError()</code>; tidak pernah dump JSON/stack ke user.</p></div>
1008
1015
  <div class="uxcard"><h4>Stream contract</h4><p>stdout = output program (teks model, receipt). stderr = progress/diagnostik. Non-TTY: 0 ANSI, 0 spinner, 0 cursor control.</p></div>
@@ -1010,9 +1017,9 @@ bun run bench # benchmark loop agen</pre></div>
1010
1017
 
1011
1018
  <p class="lede" style="margin-top:22px">Transient rendering memiliki <b>satu ownership mechanism</b> (<code>src/ui/runtime/statusline.ts</code>):</p>
1012
1019
  <div class="uxgrid">
1013
- <div class="uxcard"><h4>Ownership</h4><p>Painter garis turn (<code>turn</code>) dan wizard spinner (<code>spinner</code>) klaim via <code>acquireTransientPaint(kind)</code>; semua tulis painter lewat <code>paintWrite</code>.</p></div>
1020
+ <div class="uxcard"><h4>Ownership</h4><p>Painter garis turn (<code>turn</code>) dipakai pada shell/linier; TUI fullscreen status-nya dimiliki <code>TuiApp</code> dan clock-nya berjalan independen dari event. Wizard spinner tetap lewat <code>acquireTransientPaint(kind)</code>.</p></div>
1014
1021
  <div class="uxcard"><h4>Foreign writers</h4><p>Diagnostik non-UI (router/providers/tool warnings) boleh menulis mentah ke stderr — arbitrator mengkomitnya sebagai baris permanen saat painter aktif.</p></div>
1015
- <div class="uxcard"><h4>Lifecycle tertutup</h4><p>Garis tidak pernah stale: <code>endTurn()</code> dipanggil driver setelah setiap <code>session.run</code> settle (kernel hanya emit <code>turn:completed</code> di jalur sukses).</p></div>
1022
+ <div class="uxcard"><h4>Lifecycle tertutup</h4><p>Status TUI memiliki status <code>Working</code>/<code>Thinking</code>/<code>Running</code> dan konfirmasi <code>Stopping</code>; cleanup terjadi pada sukses, kegagalan, pembatalan, serta double-abort.</p></div>
1016
1023
  <div class="uxcard"><h4>Mutual exclusion</h4><p>Painter vs spinner secara desain disjoint; overlap memicu signal <code>[transient-paint] …</code> sekali per pasangan (bukan crash).</p></div>
1017
1024
  </div>
1018
1025
 
@@ -1058,7 +1065,7 @@ bun run bench # benchmark loop agen</pre></div>
1058
1065
  <footer class="site">
1059
1066
  <span>Minicode · Peta struktur hidup — terminal contract FROZEN (<a href="TERMINAL_CONTRACT.md">docs/TERMINAL_CONTRACT.md</a>)</span>
1060
1067
  <span class="spacer"></span>
1061
- <span>v0.10.0 · diperbarui 2026-09-21</span>
1068
+ <span>v0.11.1 · diperbarui 2026-09-24</span>
1062
1069
  </footer>
1063
1070
 
1064
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.
@@ -0,0 +1,150 @@
1
+ # Harness Agent — Riset Fondasi & Acuan Minicode
2
+
3
+ Hasil riset mendalam 2026-09-06 (Harness-Engineering, Anthropic, OpenAI,
4
+ Fowler/Böckeler, Harness-Bench, studi source-code 11 harness
5
+ arXiv:2609.00006, ReAct/Toolformer). Dokumen hidup: perbarui bila temuan
6
+ baru mengubah keputusan di bawah.
7
+
8
+ ## 1. Definisi
9
+
10
+ `Agent = Model + Harness`. Model menghasilkan teks; harness memutuskan apa
11
+ yang model lihat, apa yang boleh dilakukan, kapan berhenti, dan apa yang
12
+ terjadi saat gagal. Framework = blueprint/pustaka; harness = runtime yang
13
+ jalan di produksi. Dua tim bermodel identik bisa berbeda 40 poin completion
14
+ hanya karena harness.
15
+
16
+ Inti eksekusi = **loop ReAct** (`Thought → Action → Observation → …`)
17
+ sampai jawaban final atau batas tercapai. Terminasi harus berlapis:
18
+ tanpa tool-call, `maxSteps`, budget habis, guardrail tripwire, interupsi
19
+ user, safety refusal.
20
+
21
+ ## 2. Model kontrol Fowler (guides × sensors)
22
+
23
+ | | Computational (CPU, deterministik, murah) | Inferential (GPU, probabilistik, mahal) |
24
+ |---|---|---|
25
+ | Guide (sebelum aksi) | permission filter, allowlist, schema validator | planning agent, AGENTS.md, Skills |
26
+ | Sensor (sesudah aksi) | test, compiler, typechecker, CI | self-reflection, evaluator/judge |
27
+
28
+ Aturan: yang bisa jadi aturan deterministik → computational; yang butuh
29
+ judgment → inferential. Tiga kategori regulasi: maintainability (termudah),
30
+ architecture fitness (fitness function), behaviour (belum terpecahkan —
31
+ jangan percaya buta pada test buatan AI). Operasi: steering loop (isu
32
+ berulang → perbaiki guide/sensor) + keep quality left (cek cepat
33
+ pra-commit, cek mahal pasca-integrasi).
34
+
35
+ ## 3. Anatomi 7 subsistem (dari studi 11 harness)
36
+
37
+ Loop, integrasi LLM, tools, memori/konteks, safety/permission,
38
+ orkestrasi multi-agent, ekstensibilitas. Temuan keras:
39
+
40
+ - Kerumitan loop tidak memprediksi benchmark; scaffold ~90 baris sah.
41
+ - Tool scoping > tool count (Vercel: -80% tools = hasil naik).
42
+ - Harness produksi tidak memakai embedding retrieval (deterministik:
43
+ ripgrep/tree-sitter/glob).
44
+ - Safety 4 lapis komposisional: policy deklaratif → hooks → reviewer LLM
45
+ → OS sandbox; audit tiap lapis independen.
46
+ - Skills (`SKILL.md`) > MCP untuk adopsi lintas-harness.
47
+ - Batasan pindah dari prompt ke config terstruktur.
48
+
49
+ ## 4. Long-running (Anthropic + OpenAI)
50
+
51
+ Anthropic: compaction saja tidak cukup. Initializer (sekali: `init.sh`,
52
+ `feature_list.json` `"passes": false`, progress file, commit awal) +
53
+ coding agent (tiap sesi: baca progress+git → pilih SATU fitur → smoke test
54
+ dulu → implement → verifikasi end-to-end → commit). JSON > Markdown.
55
+ Health-check awal iterasi wajib. Evolusi: split planner/generator/evaluator
56
+ (atasi self-praise bias).
57
+
58
+ OpenAI (1M LOC, 1500 PR): beri peta bukan manual — `AGENTS.md` ~100 baris
59
+ sebagai daftar isi; enforce invariant bukan micromanage (linter custom
60
+ yang pesannya berisi instruksi remediasi); garbage collection terjadwal;
61
+ pensiunkan scaffolding tiap model baru.
62
+
63
+ ## 5. Bukti kuantitatif (Harness-Bench, 5194 trajektori)
64
+
65
+ Skor = `Security × Completion × Process`. Gap antar-harness 23,8 poin.
66
+ Lima gejala gagal: contract/format 36,4%, tool-tanpa-recovery 24,6%,
67
+ evidence/grounding 14,6%, artefak-tak-dicommit 11,1%, state 9,3%.
68
+ Yang membedakan = **execution alignment** (reasoning ↔ workspace ↔ aksi
69
+ tool ↔ kontrak evaluator tetap legibel).
70
+
71
+ ## 6. Pola terbaik (ringkas)
72
+
73
+ Done machine-readable dulu; verifikasi computational tiap aksi +
74
+ inferential selektif; tool minimum per fase; state eksternal
75
+ path-addressable & compaction-stable; health-check awal; satu fitur per
76
+ sesi + clean-state commit; generator≠evaluator; budget/timeout berlapis +
77
+ fail-closed; observability per-step; GC debt kecil-kecil; mulai dari
78
+ harness tertipis yang lolos evaluasi.
79
+
80
+ ## 7. Matriks kematangan
81
+
82
+ L1 demo (jalan, tanpa batas) → L2 terkendali (budget/abort/trace) →
83
+ L3 terverifikasi (sensor tiap aksi, evaluator terpisah) → L4 lintas-sesi
84
+ (progress+feature-list+git, resume tervalidasi) → L5 mengatur-diri
85
+ (GC, pensiun scaffolding, template per topologi).
86
+
87
+ ## 8. Posisi minicode (2026-09-07)
88
+
89
+ > Kejujuran metodologi: tidak ada skor absolut di sini. Estimasi internal
90
+ > penulis ("~8.5") berasal dari judgement + 21 run toy n=1 — itu *arah*,
91
+ > bukan *fakta*. Jangan dikutip tanpa embel-embel ini. Yang terukur dan boleh
92
+ > dikutip: gate hijau, audit 60/60, bypass-rate 0, dan run live 20/21
93
+ > execution-verified (metodologi di §9).
94
+
95
+ Kuat L2–L3 di loop/state/safety-dasar. Mendarat:
96
+ - P0: jail simetris move/delete (`permission.ts`), strict sandbox
97
+ (`bash.ts` + `MINICODE_SANDBOX_STRICT`), allowlist `bun run`/`bun x`,
98
+ scrub `exec --json` + flag `overBudget`.
99
+ - P1.3: `budgetStatus` satu predikat (`usage.ts`) + `--budget-strict` /
100
+ `MINICODE_BUDGET_STRICT` di one-shot/REPL/`exec` (`exec` sebelumnya
101
+ mengabaikan `--budget` total — diperbaiki).
102
+ - P1.2: `step-traces.jsonl` per tool/step + klasifikasi deny + mode sandbox
103
+ (`trace.ts`, wiring `cli/setup.ts`).
104
+ - P1.4: `bun run audit:harness` — 60 cek deterministik tanpa API key
105
+ (safety 6-mode, guard bypass-rate, budget, scope read-only, fake-detector).
106
+ - P1.1: terverifikasi sudah ada (`--verify` + self-heal ≤3).
107
+ - P2.1: baseline-first — bila baseline merah sebelum agen jalan, catatan
108
+ Health-Check ditempel ke prompt awal (perbaiki dulu).
109
+ - P2.2: `--tool-scope explore` / `MINICODE_TOOL_SCOPE` — sesi utama dibatasi
110
+ subset read-only bersama sub-agen (`EXPLORE_TOOL_NAMES`).
111
+ - P3.1: `minicode stats` membaca `step-traces.jsonl` — deny-rate, top tool
112
+ ditolak/gagal, mode sandbox (`summarizeStepTraces`).
113
+ - P3.2: validasi resume — workspace dibandingkan ke checkpoint terakhir
114
+ (pembukuan `.minicode/` dikecualikan); divergen → peringatan + `/undo`.
115
+ - DITOLAK sadar: verify default-on (biaya/latensi semua run + memecahkan
116
+ test existing), evaluator inferential terpisah (butuh LLM call per run).
117
+ - `bench/docker/` MENDARAT + TERVALIDASI SEBAGIAN (2026-09-08, daemon
118
+ Docker Desktop ditemukan + Ubuntu diregistrasi di WSL): 5 image era
119
+ ter-build (py36 butuh fix apt kedaluwarsa); requests-1963 collect+run OK
120
+ di py3.8; pytest-11143 FAIL dengan benar di py3.10. Sisa: run agen penuh.
121
+ - Run POSIX pertama (WSL Ubuntu): TOCTOU 1000× 0 lolos (293ms) + full
122
+ suite 1334/8/0. Temuan: (a) swapper tanpa yield menggantung selamanya —
123
+ klaim lama tak pernah tervalidasi; (b) 5 fail platform-spesifik diperbaiki
124
+ (`node -e` → runtime sendiri; stripAnsi; mount-test cabang platform;
125
+ `MINICODE_HOME` agar global-DB hermetic di POSIX; TOCTOU yield);
126
+ (c) polusi `/root/.minicode` oleh test dibersihkan.
127
+
128
+ ## 9. Uji live 7 model (2026-09-07, gateway OpenAI-compat)
129
+
130
+ Metodologi: 3 task bench × 7 model gratis, `maxSteps` 12, 2 task dengan
131
+ execution-check (import + panggil fungsi) + 1 regex-only, n=1 per sel.
132
+ Hasil ketat: 5 model 3/3 (gpt-5.6-luna paling efisien ~16k tok; muse-spark
133
+ seimbang; gemini benar semua tapi 0 token tercatat + paling lambat;
134
+ deepseek-flash boros token; glm lambat), qwen 2/3 (contract-miss:
135
+ regex lolos tapi `greet()` tak bisa di-import — pelajaran: regex saja
136
+ menipu), deepseek-pro 2/3 ketat / 3/3 longgar (file benar, jebol cap
137
+ 12 steps — artefak batas, bukan kapabilitas). Stabilitas harness 21/21
138
+ tanpa crash/hang/escape. Batasan jujur: n=1 (noise sampling), task mudah
139
+ (tak membedakan model kuat), Windows-only. Pengulangan yang berarti:
140
+ n≥3 + task multi-file + Linux CI.
141
+
142
+ Uji live 2 (2026-09-07, task multi-file-refactor + execution-check):
143
+ ketat 4/7 — luna (4 steps, 23k tok, 51 dtk, terbaik), glm (5 steps, 27k,
144
+ 34 dtk, tercepat), muse-spark (11 steps, 68k, verbose tapi benar),
145
+ deepseek-flash (6 steps, 32k, 91 dtk). Konten-benar-tapi-gagal-aturan 2/7:
146
+ pro-0813 (file benar, jebol timeout 180 dtk — provider lambat), qwen
147
+ (file benar, jebol 15 steps — pola boros langkah berulang). Gagal nyata
148
+ 1/7: gemini menjawab final dalam 851ms TANPA tool call (0 steps) —
149
+ kegagalan agentic murni, bukan kapabilitas. Task sulit MAMPU membedakan;
150
+ skor run-1 perlu n≥3 sebelum dikutip sebagai peringkat.