Plan UI/UX V6 — arsip hasil

Status: ✅ selesai (V6), dilanjutkan uji live multi-provider (V7). Ringkasan hasil di CHANGELOG.md.

Empat bug tambahan yang hanya muncul dengan provider sungguhan (V7, detail di CHANGELOG): /cost + --budget selalu nol setelah turn pertama; cli/errors.ts punya test tapi tak dipanggil sehingga body JSON provider tumpah ke layar; model :free dihargai seperti varian berbayar; exec mengirim nilai flag sebagai bagian prompt.

---

Basis: audit UI/UX menyeluruh — 24 temuan, diverifikasi dengan menjalankan tiap subcommand CLI, mengemudikan TUI lewat harness keystroke sintetis, dan memanggil handleBuiltinCommand langsung. Kondisi awal: bun test 637 pass / 1 fail (false positive), tsc --noEmit bersih, REPL tidak bisa dipakai sama sekali.

#Prinsip yang mengatur urutan

1. Test dulu untuk area yang rusak, bukan sesudah. Bug blocker (#1) lolos karena lapisan interaktif punya nol test. Menambal tanpa harness berarti bug berikutnya juga akan lolos. Fase 0 mendahului semua perbaikan.
2. Satu perubahan struktural mengalahkan lima tambalan. Kursor (#6, #11), tema (#3), warna transcript (#4) masing-masing punya satu akar. Perbaiki akarnya.
3. Jangan tambah permukaan baru sebelum yang ada bekerja. Tidak ada fitur baru di rencana ini. --ui/--tui yang menganggur (#23) dihapus, bukan diimplementasikan.
4. Ukur klaim. Setiap fase punya perintah verifikasi yang menghasilkan bukti, bukan "terlihat benar".

---

#Fase 0 — Harness test TUI (prasyarat, ~0,5 hari)

Tanpa ini fase 1–5 tidak bisa diverifikasi selain secara manual.

Harness sudah terbukti bekerja saat audit — pola: Object.defineProperty(process, "stdin", …) dengan stub setRawMode/on("data"), process.stdout.write diganti kolektor, frame diambil dari chunk yang memuat \x1b[H\x1b[2J.

Verifikasi: bun test test/tui-*.test.ts hijau; test rekursi gagal pada HEAD saat ini (membuktikan ia menangkap #1).

---

#Fase 1 — Blocker (~0,5 hari)

Verifikasi: test fase 0 hijau; bun cli/index.ts --interactive manual menerima prompt dan menampilkan jawaban; echo "x" | bun cli/index.ts --interactive tidak melempar stack trace.

---

#Fase 2 — Tema hidup & warna transcript (~1,5 hari)

Dua temuan ini membuat seluruh sistem tema dan seluruh formatting markdown/diff jadi kode mati.

#2.1 c dari closure beku → getter (#3)

src/tui/theme.ts:57-91. Objek c mengevaluasi token tema saat import, jadi applyTheme() tidak berpengaruh. Diverifikasi: applyTheme("light") lalu c.success("X") tetap mengeluarkan warna dark.

• Setiap slot jadi get success() { return trueWrap(tk("success")) }.
• Terverifikasi layak: 181 call-site c.<slot>(…) di 22 berkas tidak perlu diubah, dan const { success } = c tetap bekerja (mengambil snapshot saat destructuring — tak ada pola begitu di repo).
• c.red…c.brightCyan (#3, bagian kedua) dipetakan ke token tema, bukan hex hardcoded. Ini yang membuat mono benar-benar monokrom — jalur aksesibilitas.
• Cache per-tema (Map<ThemeName, Wrappers>) supaya getter tidak mengalokasi closure per panggilan pada jalur render panas.

DoD: applyTheme("light") mengubah keluaran c.success; applyTheme("mono") menghasilkan nol sekuens warna selain bold; NO_COLOR=1 tetap menang atas semua tema.

#2.2 Transcript berhenti membuang ANSI (#4)

src/tui/minimal/fullscreen.ts:301. push() men-strip() semua isi, jadi diff card kehilangan hijau/merah dan decorateMarkdown di baris 309/311 sia-sia.

• push menerima baris yang sudah berwarna; truncation memakai lebar visible (stripAnsi untuk mengukur, potong tanpa memutus sekuens di tengah).
• Item tool yang berisi diff card dan item agent hasil decorateMarkdown diteruskan utuh.
• Helper truncAnsi(s, w) baru — memotong berdasarkan lebar tampak dan menutup sekuens terbuka dengan \x1b[0m.

DoD: test meng-assert frame memuat sekuens hijau untuk baris + dan merah untuk -; markdown **tebal** menghasilkan \x1b[1m di frame; baris 200 karakter pada terminal 80 kolom tidak meninggalkan sekuens ANSI terpotong.

---

#Fase 3 — Cost & budget di REPL (~0,5 hari)

fullscreen.ts:110 menunggu provider:extension { kind:"usage", data.cost } yang tidak pernah dikirim provider mana pun — openai-compat.ts:92 dan anthropic.ts:137 hanya mengirim token. Cost dihitung di usage.get() yang tidak pernah dibaca TUI. --budget di-void (#5, fullscreen-driver.ts:197).

DoD: test dengan fake usage collector meng-assert cost muncul di frame setelah turn:completed; melewati batas menghasilkan item transcript peringatan dan menolak submit berikutnya.

---

#Fase 4 — Kursor & editing baris (~1 hari)

prompt-engine.ts:147 mengembalikan none untuk left/right; PromptState tidak punya posisi kursor. Diverifikasi: abcdef + panah kiri ×3 + X → abcdefX. _ di footer adalah kursor palsu yang menyesatkan.

Aman untuk emoji: backspace sudah code-point aware (prompt-engine.ts:80); logika yang sama diterapkan untuk gerakan kursor. Test emoji yang ada (prompt-engine.test.ts:219) harus tetap hijau.

DoD: abcdef + kiri×3 + X → abcXdef; Home/End berfungsi; kursor terminal tampak di posisi logis; 2000 fuzz test/fuzz-prompt.test.ts hijau dengan key baru dimasukkan ke generator.

---

#Fase 5 — Overlay, picker, mouse (~1 hari)

DoD: overlay 50 baris di terminal 20 baris bisa di-scroll penuh dan header tetap tampak; klik mouse tidak mengubah isi baris; /resume benar-benar melanjutkan sesi.

---

#Fase 6 — Konsistensi CLI (~1 hari)

DoD: minicode --version mencetak versi dari package.json; setiap subcommand tanpa argumen memberi help sendiri dengan exit 1; config list dengan ID 30 karakter tetap sejajar; satu bahasa di seluruh keluaran.

---

#Fase 7 — Kebersihan (~0,5 hari)

---

#Urutan & ketergantungan

Fase 0 (harness)
   └─> Fase 1 (blocker)        ← tanpa ini tak ada yang bisa diuji manual
          ├─> Fase 2 (tema+warna)
          ├─> Fase 3 (cost)
          ├─> Fase 4 (kursor)   ← paling besar, paling terisolasi
          └─> Fase 5 (overlay)
Fase 6, 7 (CLI, kebersihan)     ← paralel, tak bergantung TUI

Fase 6 dan 7 bisa dikerjakan siapa pun kapan pun. Fase 2–5 sebaiknya berurutan karena semuanya menyentuh fullscreen.ts.

Total: ~6,5 hari. Fase 0+1 (~1 hari) sudah memulihkan produk dari "tidak bisa dipakai" menjadi "bisa dipakai".

---

#KPI

Perintah verifikasi: bun test, bun x tsc --noEmit, bun run lint, bun test --coverage, bun run gate:coverage, ditambah manual minicode --interactive pada terminal 60×20 dan 120×40.

---

#Yang sengaja tidak dikerjakan

Agar cakupan jelas dan tidak melebar:

• Tidak ada framework TUI baru. Pure ANSI tetap. Ink/blessed akan membuang seluruh fullscreen.ts demi masalah yang perbaikannya berukuran satu baris sampai satu fungsi.
• Tidak ada wrap/scroll transcript virtual. RING_MAX 60 dan tail.slice(-bodyH) memadai; sisa PLAN_UIUX soal virtual scroll ditunda sampai ada keluhan nyata.
• Tidak ada mouse click-to-copy (PLAN_UIUX P3). Mouse tracking justru dimatikan di fase 5 — ia hanya merusak input.
• Tidak ada tema baru. Empat preset yang ada dibuat bekerja lebih dulu.
• Repo-map, OAuth live, resolve-rate, publish npm tetap di daftar tertunda PLAN_V5 — bukan UI/UX.