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.
- package/AGENTS.md +45 -0
- package/CHANGELOG.md +68 -4
- package/PLAN.md +491 -0
- package/README.md +2 -2
- package/cli/commands/acp.ts +485 -0
- package/cli/commands/auth.ts +7 -4
- package/cli/commands/config.ts +41 -27
- package/cli/commands/exec.ts +33 -12
- package/cli/commands/mcp.ts +3 -2
- package/cli/commands/memory.ts +1 -1
- package/cli/commands/pricing.ts +6 -4
- package/cli/commands/providers.ts +18 -8
- package/cli/commands/sessions.ts +11 -4
- package/cli/commands/skills.ts +3 -3
- package/cli/commands/stats.ts +3 -1
- package/cli/commands.ts +6 -0
- package/cli/index.ts +82 -57
- package/cli/model-manager.ts +6 -1
- package/cli/router.ts +7 -0
- package/cli/setup.ts +341 -5
- package/cli/tui.ts +54 -18
- package/docs/ARCHITECTURE.html +32 -25
- package/docs/CONTROL-PLANE-MAP.md +139 -0
- package/docs/HARNESS.md +150 -0
- package/docs/PLAN_UIUX_V6.md +209 -0
- package/docs/README.md +1 -1
- package/docs/SUMMARY.md +52 -0
- package/docs/TERMINAL_CONTRACT.md +372 -0
- package/docs/UI_RENDER_PIPELINE.md +169 -0
- package/docs/USAGE.md +11 -0
- package/docs/agents.md +31 -0
- package/docs/architecture.md +3 -3
- package/docs/choosing-mode.md +34 -0
- package/docs/cli.md +130 -0
- package/docs/concepts.md +53 -0
- package/docs/config-providers.md +87 -0
- package/docs/config.md +63 -0
- package/docs/contributing.md +79 -0
- package/docs/environment.md +95 -0
- package/docs/exec.md +73 -0
- package/docs/getting-started.md +102 -0
- package/docs/glossary.md +37 -0
- package/docs/mcp-lsp.md +54 -0
- package/docs/memory-sessions.md +63 -0
- package/docs/policy-sandbox.md +72 -0
- package/docs/pricing-budget.md +49 -0
- package/docs/quickstart.md +60 -0
- package/docs/repl.md +67 -0
- package/docs/security-model.md +95 -0
- package/docs/security.md +91 -0
- package/docs/skills.md +48 -0
- package/docs/terminal.md +79 -0
- package/docs/tools.md +123 -0
- package/docs/troubleshooting.md +40 -0
- package/docs/verify-benchmark.md +58 -0
- package/package.json +8 -5
- package/src/app/provider-layer.ts +12 -4
- package/src/app/session.ts +6 -0
- package/src/app/tool-layer.ts +2 -1
- package/src/constants.ts +35 -0
- package/src/lib/net.ts +6 -1
- package/src/lsp/client.ts +41 -8
- package/src/mcp/http-transport.ts +52 -15
- package/src/mcp/transport.ts +32 -1
- package/src/memory/files.ts +6 -5
- package/src/policy/allowlist.ts +1 -1
- package/src/policy/bash-guard.ts +154 -14
- package/src/policy/compaction.ts +57 -3
- package/src/policy/context.ts +4 -0
- package/src/policy/jail.ts +49 -4
- package/src/policy/permission.ts +152 -12
- package/src/policy/pricing.ts +12 -9
- package/src/presentation/adapter.ts +721 -0
- package/src/presentation/events.ts +324 -0
- package/src/presentation/label.ts +140 -0
- package/src/presentation/model.ts +172 -0
- package/src/presentation/reducer.ts +486 -0
- package/src/presentation/store.ts +256 -0
- package/src/providers/anthropic.ts +22 -4
- package/src/providers/detect.ts +2 -1
- package/src/providers/responses.ts +15 -5
- package/src/providers/router.ts +13 -0
- package/src/repo/repomap.ts +2 -29
- package/src/session/checkpoint.ts +27 -9
- package/src/session/journal.ts +27 -5
- package/src/skills/loader.ts +88 -5
- package/src/telemetry/trace.ts +36 -15
- package/src/tools/ask_user.ts +73 -4
- package/src/tools/bash.ts +15 -17
- package/src/tools/glob.ts +10 -11
- package/src/tools/lsp.ts +3 -56
- package/src/tools/memory.ts +13 -12
- package/src/tools/task.ts +1 -0
- package/src/ui/approval/prompt.ts +14 -6
- package/src/ui/assistant/simple.ts +137 -26
- package/src/ui/assistant/turn-status.ts +16 -3
- package/src/ui/contract.ts +119 -0
- package/src/ui/footer.ts +27 -5
- package/src/ui/i18n/en.ts +38 -6
- package/src/ui/i18n/id.ts +38 -6
- package/src/ui/i18n/locale.ts +3 -1
- package/src/ui/input/input.ts +51 -4
- package/src/ui/input/prompt-engine.ts +46 -4
- package/src/ui/render/collapse.ts +13 -13
- package/src/ui/render/diff.ts +7 -2
- package/src/ui/render/format.ts +16 -8
- package/src/ui/render/highlight.ts +7 -3
- package/src/ui/render/markdown.ts +5 -1
- package/src/ui/render/sanitize.ts +29 -2
- package/src/ui/render/table.ts +8 -5
- package/src/ui/render/theme.ts +18 -4
- package/src/ui/render/width.ts +89 -10
- package/src/ui/runtime/motion.ts +16 -0
- package/src/ui/runtime/screen.ts +45 -0
- package/src/ui/runtime/spinner.ts +50 -4
- package/src/ui/runtime/statusline.ts +50 -1
- package/src/ui/screens/form.ts +42 -15
- package/src/ui/screens/model-manager.ts +26 -18
- package/src/ui/screens/picker.ts +47 -23
- package/src/ui/screens/provider-manager.ts +18 -12
- package/src/ui/screens/wizard.ts +24 -8
- package/src/ui/tui/app.ts +376 -43
- package/src/ui/tui/transcript.ts +269 -65
- package/vendor/minicore/LICENSE +21 -0
- package/vendor/minicore/VENDOR.md +6 -3
- package/vendor/minicore/package.json +6 -3
- package/vendor/minicore/src/core/loop.ts +12 -2
- package/vendor/minicore/src/core/snapshot.ts +4 -0
- package/vendor/minicore/src/providers/openai-compat.ts +76 -25
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
# PLAN PENYEMPURNAAN UI/UX — Minicode 0.7.0 → 0.8.0
|
|
2
|
+
|
|
3
|
+
**Status:** ✅ selesai (V6), dilanjutkan uji live multi-provider (V7). Ringkasan hasil di [CHANGELOG.md](../CHANGELOG.md).
|
|
4
|
+
|
|
5
|
+
| Metrik | Target | Hasil V6 | Hasil V7 (uji live) |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| REPL menerima prompt | ya | ✅ | ✅ diverifikasi dengan 2 gateway nyata |
|
|
8
|
+
| Test | seluruhnya hijau | 859 pass | **913 pass, 0 fail** |
|
|
9
|
+
| Coverage agregat | ≥65% cli/ | 79,33% / 82,15% | **80,52% funcs / 83,10% lines** |
|
|
10
|
+
| Berkas UI di 0% coverage | ≤6 | ✅ 6 | ✅ 6 |
|
|
11
|
+
| Gate coverage | naik dari 69/74 | min 77/80 | min 77/80 (aktual 80,5/83,1) |
|
|
12
|
+
| Resolve-rate terukur | — | belum diukur | **1,00** (5/5 tugas berpemeriksa objektif) |
|
|
13
|
+
|
|
14
|
+
**Empat bug tambahan yang hanya muncul dengan provider sungguhan** (V7, detail di CHANGELOG):
|
|
15
|
+
`/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.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
**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**.
|
|
20
|
+
|
|
21
|
+
## Prinsip yang mengatur urutan
|
|
22
|
+
|
|
23
|
+
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.
|
|
24
|
+
2. **Satu perubahan struktural mengalahkan lima tambalan.** Kursor (#6, #11), tema (#3), warna transcript (#4) masing-masing punya satu akar. Perbaiki akarnya.
|
|
25
|
+
3. **Jangan tambah permukaan baru sebelum yang ada bekerja.** Tidak ada fitur baru di rencana ini. `--ui`/`--tui` yang menganggur (#23) dihapus, bukan diimplementasikan.
|
|
26
|
+
4. **Ukur klaim.** Setiap fase punya perintah verifikasi yang menghasilkan bukti, bukan "terlihat benar".
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Fase 0 — Harness test TUI (prasyarat, ~0,5 hari)
|
|
31
|
+
|
|
32
|
+
Tanpa ini fase 1–5 tidak bisa diverifikasi selain secara manual.
|
|
33
|
+
|
|
34
|
+
| Item | Berkas | DoD |
|
|
35
|
+
|---|---|---|
|
|
36
|
+
| Harness fake TTY: stdin injektabel + stdout tertangkap sebagai frame | `test/helpers/tui-harness.ts` (baru) | `send("/s")` → frame terakhir bisa di-assert; `columns`/`rows` bisa diatur per test |
|
|
37
|
+
| Test `attachFullscreenMinimal` | `test/tui-fullscreen.test.ts` (baru) | 15 skenario: dropdown, filter, panah, Tab, submit, overlay, picker, streaming, tool+diff, history, perintah tak dikenal, Shift+Tab, Ctrl+O, baris panjang, Ctrl+C ×2 |
|
|
38
|
+
| Test `askLine` + `runPicker` + `runPanel` + `runProviderManager` | `test/tui-classic.test.ts` (baru) | render awal, dropdown, seleksi, submit, filter kosong, Esc dua tingkat, fallback non-TTY |
|
|
39
|
+
| Assertion anti-regresi rekursi | `test/tui-fullscreen.test.ts` | `submit` memicu `onLine` **tepat 1×**; `unhandledRejection` tetap kosong sepanjang test |
|
|
40
|
+
|
|
41
|
+
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`.
|
|
42
|
+
|
|
43
|
+
**Verifikasi:** `bun test test/tui-*.test.ts` hijau; test rekursi **gagal** pada `HEAD` saat ini (membuktikan ia menangkap #1).
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Fase 1 — Blocker (~0,5 hari)
|
|
48
|
+
|
|
49
|
+
| # | Masalah | Berkas | Perbaikan |
|
|
50
|
+
|---|---|---|---|
|
|
51
|
+
| 1 | Rekursi tak berbatas spinner → REPL mati bisu pada prompt pertama | `src/tui/minimal/fullscreen.ts:263` | `startSpinner` men-set `spinnerTimer = setTimeout(tickSpinner, 150)` alih-alih memanggil `tickSpinner()` langsung |
|
|
52
|
+
| 2 | `setRawMode is not a function` di luar TTY | `src/tui/minimal/fullscreen.ts:384` | Guard `process.stdin.isTTY`; non-TTY → jalur baca baris sederhana, bukan alternate-screen |
|
|
53
|
+
| — | Kegagalan bisu di masa depan | `src/tui/minimal/fullscreen.ts` | `process.on("unhandledRejection")` di driver → tampilkan sebagai item transcript `error` + restore kursor; tidak ada lagi hang tanpa pesan |
|
|
54
|
+
|
|
55
|
+
**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.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Fase 2 — Tema hidup & warna transcript (~1,5 hari)
|
|
60
|
+
|
|
61
|
+
Dua temuan ini membuat seluruh sistem tema dan seluruh formatting markdown/diff jadi kode mati.
|
|
62
|
+
|
|
63
|
+
### 2.1 `c` dari closure beku → getter (#3)
|
|
64
|
+
|
|
65
|
+
`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.
|
|
66
|
+
|
|
67
|
+
- Setiap slot jadi `get success() { return trueWrap(tk("success")) }`.
|
|
68
|
+
- **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).
|
|
69
|
+
- `c.red`…`c.brightCyan` (#3, bagian kedua) dipetakan ke token tema, bukan hex hardcoded. Ini yang membuat `mono` benar-benar monokrom — jalur aksesibilitas.
|
|
70
|
+
- Cache per-tema (`Map<ThemeName, Wrappers>`) supaya getter tidak mengalokasi closure per panggilan pada jalur render panas.
|
|
71
|
+
|
|
72
|
+
**DoD:** `applyTheme("light")` mengubah keluaran `c.success`; `applyTheme("mono")` menghasilkan nol sekuens warna selain bold; `NO_COLOR=1` tetap menang atas semua tema.
|
|
73
|
+
|
|
74
|
+
### 2.2 Transcript berhenti membuang ANSI (#4)
|
|
75
|
+
|
|
76
|
+
`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.
|
|
77
|
+
|
|
78
|
+
- `push` menerima baris yang sudah berwarna; truncation memakai lebar **visible** (`stripAnsi` untuk mengukur, potong tanpa memutus sekuens di tengah).
|
|
79
|
+
- Item `tool` yang berisi diff card dan item `agent` hasil `decorateMarkdown` diteruskan utuh.
|
|
80
|
+
- Helper `truncAnsi(s, w)` baru — memotong berdasarkan lebar tampak dan menutup sekuens terbuka dengan `\x1b[0m`.
|
|
81
|
+
|
|
82
|
+
**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.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Fase 3 — Cost & budget di REPL (~0,5 hari)
|
|
87
|
+
|
|
88
|
+
`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`).
|
|
89
|
+
|
|
90
|
+
| Item | Berkas |
|
|
91
|
+
|---|---|
|
|
92
|
+
| `FullscreenMinimalOpts` menerima `usage(): Usage` alih-alih menebak dari event | `src/tui/minimal/fullscreen.ts:35` |
|
|
93
|
+
| Header/footer membaca `usage().cost` pada tiap render | `src/tui/minimal/fullscreen.ts:324, 375` |
|
|
94
|
+
| Peringatan 80% + hentikan saat lewat batas, sejajar jalur one-shot (`cli/index.ts:220-235`) | `cli/fullscreen-driver.ts` |
|
|
95
|
+
| Indikator budget di header: `$0.0123 / $5.00` | `src/tui/minimal/fullscreen.ts` |
|
|
96
|
+
|
|
97
|
+
**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.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Fase 4 — Kursor & editing baris (~1 hari)
|
|
102
|
+
|
|
103
|
+
`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.
|
|
104
|
+
|
|
105
|
+
| Item | Berkas |
|
|
106
|
+
|---|---|
|
|
107
|
+
| `PromptState` + `cursor: number` (indeks code-point, bukan UTF-16 unit) | `cli/prompt-engine.ts:5` |
|
|
108
|
+
| `char`/`backspace` menyisip/hapus **di posisi kursor**, bukan hanya di ujung | `cli/prompt-engine.ts:65-92` |
|
|
109
|
+
| `left`/`right` bergerak; `home`/`end`/`ctrl-a`/`ctrl-e` ditambahkan ke `PromptKey` + `decodeKey` (`ESC[H`, `ESC[F`, `ESC[1~`, `ESC[4~`) | `cli/prompt-engine.ts:26, 201` |
|
|
110
|
+
| `ctrl-w`/`ctrl-u` menghormati kursor (hapus kata sebelum kursor / ke awal baris) | `cli/prompt-engine.ts:129-146` |
|
|
111
|
+
| Renderer memposisikan kursor sungguhan (`ESC[<n>G`) dan berhenti mencetak `_` | `src/tui/minimal/fullscreen.ts:367`, `cli/input.ts:111` |
|
|
112
|
+
| Tab menghormati seleksi, bukan selalu item pertama (#11) — `pickFirst` → `pickSelected ?? pickFirst` | `cli/prompt-engine.ts:109` |
|
|
113
|
+
| Horizontal scroll `scrollableLine` mengikuti kursor, bukan hanya ujung | `cli/input.ts:103` |
|
|
114
|
+
|
|
115
|
+
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.
|
|
116
|
+
|
|
117
|
+
**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.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Fase 5 — Overlay, picker, mouse (~1 hari)
|
|
122
|
+
|
|
123
|
+
| # | Masalah | Berkas | Perbaikan |
|
|
124
|
+
|---|---|---|---|
|
|
125
|
+
| 7 | Overlay meluber melewati tinggi terminal dan tidak bisa di-scroll — 30 baris dirender penuh di terminal 20 baris, header terguling keluar | `fullscreen.ts:287, 344` | Slice ke `overlayLines`, state `overlayScroll`, panah/PgUp/PgDn, indikator `n/total`. Pinjam logika `cli/panel.ts:64-82` yang sudah benar |
|
|
126
|
+
| 8 | Byte mouse bocor jadi teks (`teks` → `teks 00` saat diklik) | `screen.ts:30`, `prompt-engine.ts:225` | Hapus `enableMouse()`/`disableMouse()` — tidak ada konsumennya. `decodeKey` mengenali dan **membuang** `ESC[M`+3 byte serta SGR `ESC[<…M/m` untuk terminal yang mengirimnya sendiri |
|
|
127
|
+
| 9 | `/resume` di TUI hanya mencetak instruksi manual | `fullscreen-driver.ts:114` | Respawn dengan `--resume <id>` seperti jalur klasik (`commands.ts:326`) |
|
|
128
|
+
| 9b | Tiap slash command menembak `onPicker` → `onOverlay` → `onLine` berurutan | `fullscreen.ts:218-241` | Satu tabel dispatch: `builtin(picker) | builtin(overlay) | skill | prompt`, diputuskan sebelum eksekusi, bukan dengan mencoba tiga jalur |
|
|
129
|
+
| 10 | Panah atas menggabungkan history ke teks yang ada (`halo` → `halo audit dong…`) | `cli/input.ts:198` | Ganti baris, jangan gabungkan — sejajar dengan perilaku shell dan dengan jalur fullscreen |
|
|
130
|
+
|
|
131
|
+
**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.
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Fase 6 — Konsistensi CLI (~1 hari)
|
|
136
|
+
|
|
137
|
+
| # | Item | Berkas |
|
|
138
|
+
|---|---|---|
|
|
139
|
+
| 12 | `--version` / `-v` — saat ini dikirim ke LLM sebagai prompt. Versi dibaca dari `package.json`, bukan hardcode di dua tempat | `cli/index.ts:66`, hapus literal di `:72` |
|
|
140
|
+
| 13 | `config`, `config mcp`, `config lsp`, `mcp` tanpa argumen mencetak HELP global 45 baris dan exit 0 → help kontekstual per subcommand + exit 1, mengikuti pola `auth`/`pricing` yang sudah rapi | `cli/commands/config.ts:185,253,257`, `cli/commands/mcp.ts` |
|
|
141
|
+
| 14 | `stats --json` mengabaikan flag | `cli/commands/stats.ts:20` |
|
|
142
|
+
| 15 | `renderTable`: `width` adalah minimum, bukan maksimum → kolom melebar dan header tidak lagi berbaris (nyata di `config list` dengan ID 23 karakter) | `src/tui/table.ts:20` — `width` jadi batas keras, isi lebih panjang dipotong dengan `…` |
|
|
143
|
+
| 16 | Alignment `providers` rusak untuk ID panjang | `cli/commands/providers.ts:69` — pakai `renderTable` alih-alih `padEnd(16)` manual |
|
|
144
|
+
| 17 | Bahasa campur: `providers`/`config`/`skills`/`sessions` Inggris, `auth`/`pricing`/TUI Indonesia, dalam satu sesi user melihat keduanya | seluruh `cli/` — **pilih Indonesia** (mayoritas permukaan interaktif sudah Indonesia); pesan `usage:` tetap Inggris karena konvensi CLI |
|
|
145
|
+
| 18 | Notice `[sandbox]` muncul di stderr untuk **setiap** perintah di Windows, termasuk yang tak menjalankan tool | `cli/index.ts:138` — tampilkan hanya bila sesi berpotensi menjalankan bash |
|
|
146
|
+
| 22 | `/help` tidak menyebut Ctrl+O, Ctrl+R, Shift+Tab, Ctrl+U, Ctrl+W, Esc, `\` continuation | `cli/commands.ts:60` — bagian "Keyboard" |
|
|
147
|
+
|
|
148
|
+
**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.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Fase 7 — Kebersihan (~0,5 hari)
|
|
153
|
+
|
|
154
|
+
| # | Item | Berkas |
|
|
155
|
+
|---|---|---|
|
|
156
|
+
| 19 | `stripAnsi` terduplikasi; `ANSI_PATTERN` tidak menangkap private-mode (`ESC[?25l`, `ESC[?2026h` lolos utuh — masuk ke teks overlay via `captureOutput`) | `src/tui/theme.ts:122` perluas pola; `src/tui/wrap.ts:6` re-export |
|
|
157
|
+
| 20 | Justify menjustifikasi baris terakhir paragraf → "sungai" spasi (`dengan lebar tertentu`) | `src/tui/wrap.ts:62` — baris terakhir rata kiri; `MINICODE_JUSTIFY=0` untuk mematikan |
|
|
158
|
+
| 21 | `/thinking` punya dua state (`process.env` dan `showThinking.ref`) dan **nol konsumen** — melapor sukses tanpa efek | satu state di `showThinking`, dibaca `simple.ts:60` dan `fullscreen.ts` untuk event `reasoning` |
|
|
159
|
+
| 23 | `--ui auto|full|classic` diparse, diteruskan, tidak pernah dibaca; `--tui` juga tidak berpengaruh | hapus `--ui` dari `cli/args.ts:24` dan `cli/index.ts:146`; `--tui` didokumentasikan sebagai default REPL atau dihapus dari HELP |
|
|
160
|
+
| 24 | `import-convention.test.ts` false positive (mendeteksi berkas test-nya sendiri) | `test/import-convention.test.ts:43` — kecualikan berkas yang memuat pola sebagai literal |
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Urutan & ketergantungan
|
|
165
|
+
|
|
166
|
+
```
|
|
167
|
+
Fase 0 (harness)
|
|
168
|
+
└─> Fase 1 (blocker) ← tanpa ini tak ada yang bisa diuji manual
|
|
169
|
+
├─> Fase 2 (tema+warna)
|
|
170
|
+
├─> Fase 3 (cost)
|
|
171
|
+
├─> Fase 4 (kursor) ← paling besar, paling terisolasi
|
|
172
|
+
└─> Fase 5 (overlay)
|
|
173
|
+
Fase 6, 7 (CLI, kebersihan) ← paralel, tak bergantung TUI
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Fase 6 dan 7 bisa dikerjakan siapa pun kapan pun. Fase 2–5 sebaiknya berurutan karena semuanya menyentuh `fullscreen.ts`.
|
|
177
|
+
|
|
178
|
+
**Total: ~6,5 hari.** Fase 0+1 (~1 hari) sudah memulihkan produk dari "tidak bisa dipakai" menjadi "bisa dipakai".
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## KPI
|
|
183
|
+
|
|
184
|
+
| Metrik | Sebelum | Target |
|
|
185
|
+
|---|---|---|
|
|
186
|
+
| REPL menerima prompt | **tidak** | ya |
|
|
187
|
+
| Test lapisan interaktif | 0 berkas | `fullscreen.ts`, `input.ts`, `picker.ts`, `panel.ts`, `provider-manager.ts` ≥70% lines |
|
|
188
|
+
| Coverage `cli/` | 49% lines | ≥65% |
|
|
189
|
+
| Berkas UI di 0% coverage | 19 | ≤6 (jalur yang butuh proses nyata: `index.ts`, `setup.ts`, `exec.ts`, `auth.ts`, `wizard.ts`, `screen.ts`) |
|
|
190
|
+
| `applyTheme` mengubah warna | tidak | 4 preset, terverifikasi per slot |
|
|
191
|
+
| Warna diff/markdown di TUI | dibuang | dipertahankan |
|
|
192
|
+
| Cost tampil di REPL | tidak | ya, + peringatan budget |
|
|
193
|
+
| Editing di tengah baris | tidak | kursor penuh + Home/End |
|
|
194
|
+
| Overlay > tinggi terminal | meluber | scroll + indikator |
|
|
195
|
+
| `bun test` | 637 pass / 1 fail | seluruhnya hijau |
|
|
196
|
+
|
|
197
|
+
**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.
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## Yang sengaja tidak dikerjakan
|
|
202
|
+
|
|
203
|
+
Agar cakupan jelas dan tidak melebar:
|
|
204
|
+
|
|
205
|
+
- **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.
|
|
206
|
+
- **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.
|
|
207
|
+
- **Tidak ada mouse click-to-copy** (PLAN_UIUX P3). Mouse tracking justru dimatikan di fase 5 — ia hanya merusak input.
|
|
208
|
+
- **Tidak ada tema baru.** Empat preset yang ada dibuat bekerja lebih dulu.
|
|
209
|
+
- **Repo-map, OAuth live, resolve-rate, publish npm** tetap di daftar tertunda PLAN_V5 — bukan UI/UX.
|
package/docs/README.md
CHANGED
|
@@ -96,7 +96,7 @@ Habis itu, baca sesuai kebutuhan lewat tabel Navigasi di bawah — tak perlu ber
|
|
|
96
96
|
| Threat model, prompt injection, supply chain | [Keamanan](security.md) |
|
|
97
97
|
| Error umum + `doctor` | [Troubleshooting](troubleshooting.md) |
|
|
98
98
|
| Peta lapisan, alur satu prompt | [Arsitektur](architecture.md) |
|
|
99
|
-
| Kontrak stdout/stderr FROZEN,
|
|
99
|
+
| Kontrak stdout/stderr FROZEN, invariant I1–I30 | [Kontrak Terminal](terminal.md) |
|
|
100
100
|
| Kontrak internal kontributor: terminal FROZEN, control-plane, pipeline render | [Internal & Arsitektur](TERMINAL_CONTRACT.md) (grup di sidebar) |
|
|
101
101
|
| Ikut kontribusi, gate, batas lapisan | [Contributing](contributing.md) |
|
|
102
102
|
| Perubahan per versi | [Changelog](changelog.md) |
|
package/docs/SUMMARY.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Summary
|
|
2
|
+
|
|
3
|
+
* [Minicode — Dokumentasi](README.md)
|
|
4
|
+
|
|
5
|
+
## Memulai
|
|
6
|
+
|
|
7
|
+
* [Konsep & Desain](concepts.md)
|
|
8
|
+
* [Instalasi](getting-started.md)
|
|
9
|
+
* [Quickstart 5 menit](quickstart.md)
|
|
10
|
+
* [Glosarium](glossary.md)
|
|
11
|
+
|
|
12
|
+
## Menggunakan
|
|
13
|
+
|
|
14
|
+
* [CLI — Mode & Flags](cli.md)
|
|
15
|
+
* [Memilih Mode](choosing-mode.md)
|
|
16
|
+
* [REPL — Slash & Keyboard](repl.md)
|
|
17
|
+
* [Otomasi & CI](exec.md)
|
|
18
|
+
* [Config — File & Lokasi Data](config.md)
|
|
19
|
+
* [Config & Provider](config-providers.md)
|
|
20
|
+
* [Pricing & Budget](pricing-budget.md)
|
|
21
|
+
* [Environment Variables](environment.md)
|
|
22
|
+
* [Skills & Hooks](skills.md)
|
|
23
|
+
|
|
24
|
+
## Referensi
|
|
25
|
+
|
|
26
|
+
* [Tools (37)](tools.md)
|
|
27
|
+
* [Sub-Agents & Tasks](agents.md)
|
|
28
|
+
* [MCP & LSP](mcp-lsp.md)
|
|
29
|
+
* [Memory & Sessions](memory-sessions.md)
|
|
30
|
+
* [Verify & Benchmark](verify-benchmark.md)
|
|
31
|
+
|
|
32
|
+
## Keamanan
|
|
33
|
+
|
|
34
|
+
* [Security Model](security-model.md)
|
|
35
|
+
* [Policy & Sandbox](policy-sandbox.md)
|
|
36
|
+
* [Keamanan](security.md)
|
|
37
|
+
* [Troubleshooting](troubleshooting.md)
|
|
38
|
+
|
|
39
|
+
## Kontribusi & Arsitektur
|
|
40
|
+
|
|
41
|
+
* [Arsitektur](architecture.md)
|
|
42
|
+
* [Kontrak Terminal](terminal.md)
|
|
43
|
+
* [Contributing](contributing.md)
|
|
44
|
+
* [Changelog](changelog.md)
|
|
45
|
+
|
|
46
|
+
## Internal & Arsitektur (untuk kontributor)
|
|
47
|
+
|
|
48
|
+
* [Terminal Contract (FROZEN) — 30 invariant](TERMINAL_CONTRACT.md)
|
|
49
|
+
* [Control Plane — kontrak context/budget/compaction](CONTROL-PLANE-MAP.md)
|
|
50
|
+
* [UI Render Pipeline — jalur stream ke terminal](UI_RENDER_PIPELINE.md)
|
|
51
|
+
* [Harness Agent — riset fondasi](HARNESS.md)
|
|
52
|
+
* [Plan UI/UX V6 — arsip hasil](PLAN_UIUX_V6.md)
|
|
@@ -0,0 +1,372 @@
|
|
|
1
|
+
# Kontrak Terminal MiniCode (TUI fullscreen — v7, 2026-09-23)
|
|
2
|
+
|
|
3
|
+
Perubahan v7 (temuan audit `audit-tui`): penanganan sinyal fatal
|
|
4
|
+
SIGTERM/SIGHUP (I31), navigasi transkrip Home/End + Shift+PgUp/PgDn (I14),
|
|
5
|
+
hint abort sekali saat busy (I14), idle guard form dua-tahap (I21), spark
|
|
6
|
+
statis via `MINICODE_MOTION=0` (I13), parkir kursor di dalam blok
|
|
7
|
+
sync-update (I25).
|
|
8
|
+
|
|
9
|
+
Satu-satunya tampilan interaktif adalah **TUI fullscreen**: transkrip ala
|
|
10
|
+
shell + status bar + popup komposit. REPL linier, footer lengket (chrome),
|
|
11
|
+
overlay inline, dan jendela info **DIHAPUS** — tak ada mode, tak ada flag
|
|
12
|
+
(`--tui` usang = no-op). Popup = satu kotak: daftar DAN input teks/pilihan
|
|
13
|
+
terjadi di dalamnya (form); tak ada ketikan di luar kotak. Bahasa UI
|
|
14
|
+
dwibahasa (en/id) via i18n nol-dependensi. Perubahan perilaku apa pun di
|
|
15
|
+
bawah wajib: update dokumen ini + test yang menjaganya (lihat "Peta
|
|
16
|
+
proteksi").
|
|
17
|
+
|
|
18
|
+
## Sifat produk
|
|
19
|
+
|
|
20
|
+
- **Interaktif (TTY mampu)**: aplikasi fullscreen alternate-screen dari start
|
|
21
|
+
sampai quit. Area transkrip bergaya shell (prompt `minicode ›`, jawaban
|
|
22
|
+
model, ledger `›`), status bar bawah, popup kecil di atas transkrip yang
|
|
23
|
+
tetap terlihat (redup) di belakang. Keluar = buffer utama kembali persis
|
|
24
|
+
(transkrip sesi tidak di-dump ke scrollback).
|
|
25
|
+
- **Non-interaktif** (one-shot prompt, `exec`, pipe/redirect/CI): cetak polos,
|
|
26
|
+
tak pernah membuka TUI.
|
|
27
|
+
- Tanpa panel/sidebar; tanpa mouse; tanpa animasi dekoratif (pulse spark
|
|
28
|
+
status bar dapat dimatikan `MINICODE_MOTION=0` — I13).
|
|
29
|
+
|
|
30
|
+
## Contract stdout/stderr
|
|
31
|
+
|
|
32
|
+
| Stream | Isi | Catatan |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| stdout | Output PROGRAM yang bermakna: teks model, receipt perubahan (`› write_file …`), daftar/artefak perintah | Harus bersih dari cursor-control pada non-TTY |
|
|
35
|
+
| stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
|
|
36
|
+
| keduanya | Warna hanya bila stream TTY (`stdout.isTTY`); `NO_COLOR` menang; TERM/COLORTERM env TIDAK menyalakan warna pada pipe/redirect | Lihat `src/ui/render/theme.ts` `colorLevel()` |
|
|
37
|
+
|
|
38
|
+
Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
39
|
+
0 animasi spinner, 0 ANSI yang tidak diperlukan, output deterministic.**
|
|
40
|
+
|
|
41
|
+
## Klasifikasi writer (wajib dipatuhi)
|
|
42
|
+
|
|
43
|
+
1. **permanent user-visible output** — teks model, receipt, hasil perintah → stdout (idle non-interaktif).
|
|
44
|
+
2. **frame TUI** — SATU-SATUNYA penulis layar saat interaktif adalah `App`
|
|
45
|
+
(`src/ui/tui/app.ts`): transkrip viewport + prompt + status bar + komposit
|
|
46
|
+
popup, satu repaint sinkron per event. Modul lain DILARANG menulis
|
|
47
|
+
`process.stdout` langsung saat App aktif (popup melukis regionnya via
|
|
48
|
+
`paintRegion`, bukan frame penuh).
|
|
49
|
+
3. **diagnostic/logging** — `[warn]`, `[router]`, `[mcp]`, `[vector]`, dst. dari layer non-UI → boleh `process.stderr.write` mentah.
|
|
50
|
+
4. **machine-readable output** — mis. `--json`, protokol MCP server → stdout saja, tanpa apa pun yang lain.
|
|
51
|
+
5. **debug-only output** — guard `verbose`/env; tidak pernah default.
|
|
52
|
+
|
|
53
|
+
## Ownership
|
|
54
|
+
|
|
55
|
+
- `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit —
|
|
56
|
+
selalu berpasangan, termasuk exception/SIGINT via handler `process.on("exit")`
|
|
57
|
+
sinkron best-effort). Turn berjalan = indikator spark pada status bar.
|
|
58
|
+
- **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
|
|
59
|
+
`process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
|
|
60
|
+
tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
|
|
61
|
+
→ restore terminal (alt-screen exit + raw mode pulih) lalu
|
|
62
|
+
`process.exit(128+n)`. Pasangan ketat: keduanya dilepas di cleanup `run()` —
|
|
63
|
+
tanpa sesi TUI, sinyal TIDAK di-intercept (perilaku default proses tetap).
|
|
64
|
+
Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
|
|
65
|
+
`reset`).
|
|
66
|
+
- App me-repaint live mengikuti event bus (stream teks, ledger, thinking;
|
|
67
|
+
coalesce 30ms) — TANPA ini layar buta selama turn. Suspend menahan repaint
|
|
68
|
+
(popup melukis sendiri); quit menahan semua.
|
|
69
|
+
- Popup komposit (`/model`, `/provider`, `/sessions`, form, approval):
|
|
70
|
+
controller/view memanggil `app.suspend()` (lepas listener stdin + redupkan
|
|
71
|
+
layar), view melukis HANYA region kotak via `paintRegion` (tanpa clear —
|
|
72
|
+
transkrip di belakang tetap tampil), `app.resume()` repaint penuh saat tutup.
|
|
73
|
+
Tanpa suspend: byte masuk ke dua tempat (App + popup) dan frame App menimpa
|
|
74
|
+
popup — dilarang.
|
|
75
|
+
- Saat turn berjalan SEMUA input dibekukan kecuali abort (Esc/Ctrl+C) dan
|
|
76
|
+
scroll (PgUp/PgDn). Enter saat busy = sunyi (bukan antre, bukan petunjuk).
|
|
77
|
+
Abort pertama menampilkan hint "tekan Esc/Ctrl+C lagi untuk keluar" di slot
|
|
78
|
+
indikator SEKALI (anti keluar sesi tak sengaja saat double-tap "memastikan"
|
|
79
|
+
— I14); abort kedua dalam 1,5 dtk = quit.
|
|
80
|
+
|
|
81
|
+
## Popup, dialog, form & i18n
|
|
82
|
+
|
|
83
|
+
- `screen.ts` = pemilik `?1049h/?1049l` + `paintRegion` (cursor-addressed,
|
|
84
|
+
tanpa clear) + `clearRegion`. Refcount nested, idempoten, null-screen
|
|
85
|
+
fail-closed di non-TTY/`TERM=dumb`. Siklus hidup region: render yang
|
|
86
|
+
menyusut/bergeser membersihkan union lama+baru (tanpa baris hantu); tutup
|
|
87
|
+
menghapus region sendiri sebelum pemilik repaint.
|
|
88
|
+
- Isi popup: kotak terpusat (`dialog.ts`: border, judul opsional dalam garis
|
|
89
|
+
atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
|
|
90
|
+
`dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
|
|
91
|
+
sendiri.
|
|
92
|
+
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 76,
|
|
93
|
+
form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
|
|
94
|
+
Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
|
|
95
|
+
hilang, id selamat).
|
|
96
|
+
- Form dalam popup (`form.ts`): field text/secret(mask `•`)/select/confirm,
|
|
97
|
+
Tab/↑↓ pindah, ←/→ pilih atau geser kursor, Enter validasi+submit, Esc
|
|
98
|
+
dua-tahap (tekan-1 bersihkan field aktif, tekan-2 batal — isi tidak pernah
|
|
99
|
+
hilang sekali tekan); error validasi merah dalam box; kursor terminal
|
|
100
|
+
diparkir di field aktif. Add/edit provider, delete confirm, dan wizard
|
|
101
|
+
input WAJIB lewat ini (bukan askLine liar di luar kotak).
|
|
102
|
+
- Dropdown `/` tetap inline menempel prompt (harus mengikuti kursor ketik):
|
|
103
|
+
berbingkai, terhapus di SEMUA jalur keluar.
|
|
104
|
+
- **Kursor diparkir di SEMUA permukaan** (picker/manager/form/App): baris
|
|
105
|
+
item/field aktif — bukan ditinggal di posisi paint terakhir.
|
|
106
|
+
- **i18n dwibahasa** (`src/ui/i18n/`): kamus statis `en.ts`/`id.ts` (id WAJIB
|
|
107
|
+
kunci = en — tsc mengawal), `t(key, params)` interpolasi `{nama}`, fallback
|
|
108
|
+
kunci hilang → en. Prioritas: `/lang` (sesi) > `MINICODE_LANG` >
|
|
109
|
+
state.json `lang` > locale OS (`LANG`/`LC_ALL` awalan `id`) > en. Semua
|
|
110
|
+
string user-visible TUI lewat `t()` — literal Indonesia hardcode di luar
|
|
111
|
+
dict dilarang (test anti-regresi). Getter runtime, bukan const beku.
|
|
112
|
+
- **Keybinding konsisten** (kontrak I25): `Esc` dua-tahap di semua input
|
|
113
|
+
teks; `backspace`/`delete` selalu edit teks (aksi hapus-data via `d`/
|
|
114
|
+
`Del` + confirm dalam popup, tercatat); navigasi daftar = `↑↓` + `pgup/
|
|
115
|
+
pgdn` + `home/end` di semua popup ber-daftar; hint footer tiap permukaan
|
|
116
|
+
hanya tombol yang benar-benar berlaku di sana.
|
|
117
|
+
- Approval tool & ask_user: blok pertanyaan + keputusan DICATAT di transkrip
|
|
118
|
+
(jejak audit) dan layar di-repaint sebelum menjawab; input via askLine di
|
|
119
|
+
baris kursor (aman: input App beku saat busy; Esc/Ctrl+C = abort + deny).
|
|
120
|
+
- Layar tak mampu (non-TTY, `rows < 10`, `TERM=dumb`): view menolak BERSUARA
|
|
121
|
+
+ batal (fail-closed). TAK BOLEH diam.
|
|
122
|
+
- `/status` & `/history` = readout ke transkrip (bukan popup); `/help` ringkas
|
|
123
|
+
(≤6 baris, penuh via `/help tombol`); `/expand` membuka buffer isi tool;
|
|
124
|
+
pilihan `/model` persist antar sesi + struk `model: x` di transkrip.
|
|
125
|
+
|
|
126
|
+
## Invariant (nomor dipakai di peta proteksi)
|
|
127
|
+
|
|
128
|
+
1. Satu tampilan interaktif: TUI fullscreen; frame penuh tiap repaint (tepat
|
|
129
|
+
`rows` baris); scrollback utama tak tersentuh selama sesi.
|
|
130
|
+
2. stdout/stderr contract seperti tabel di atas (TTY & non-TTY deterministic).
|
|
131
|
+
3. Satu kepemilikan layar (`App`); popup satu lifecycle (`suspend`/`resume` +
|
|
132
|
+
`paintRegion`).
|
|
133
|
+
4. Permanent output tidak bergantung pada painter TUI.
|
|
134
|
+
5. Tidak ada popup yatim / input bocor setelah success / failure /
|
|
135
|
+
cancellation / SIGINT / session end. Tidak ada modal yatim.
|
|
136
|
+
6. Non-TTY: 0 cursor control / alternate screen / spinner animation / ANSI
|
|
137
|
+
tak diperlukan.
|
|
138
|
+
7. Tool activity default compact; ledger `› nama target` satu baris.
|
|
139
|
+
8. Streaming tanpa duplicate output / overlap / stale status.
|
|
140
|
+
9. Foreign stderr writers boleh mentah di layer non-UI.
|
|
141
|
+
10. (Dilebur ke I3 — nomor dipertahankan agar referensi lama tak patah.)
|
|
142
|
+
11. Resize memakai lebar/tinggi SAAT PAINT (bukan saat event) — termasuk
|
|
143
|
+
geometri popup, dialog, dan viewport TUI.
|
|
144
|
+
12. Long session tetap readable (cap 5000 baris, tertua dibuang). Proyeksi
|
|
145
|
+
presentasi mempertahankan cap yang sama dan menambahkan satu marker
|
|
146
|
+
`… N baris awal di luar viewport — riwayat penuh di model` yang melacak
|
|
147
|
+
jumlah baris yang di-evict; `total()` tetap monotonik.
|
|
148
|
+
|
|
149
|
+
13. Status bar: 1 baris dasar (`✦ [status] mode • model • cwd … ctx`) dari
|
|
150
|
+
sumber yang sama dengan angka sesi. Saat turn aktif, status teks dan
|
|
151
|
+
elapsed selalu tampil tanpa bergantung pada event provider; `Working`
|
|
152
|
+
berarti turn hidup, `Thinking` hanya untuk reasoning nyata, dan tool
|
|
153
|
+
running memakai label/tool target. Spark pulse saat busy;
|
|
154
|
+
`MINICODE_MOTION=0` mematikan pulse (status textual tetap tampil dan
|
|
155
|
+
tidak boleh identik dengan idle; aksesibilitas/SSH lambat/rekaman; temuan
|
|
156
|
+
audit TUI-006), dibaca saat dipakai (bukan beku saat import).
|
|
157
|
+
14. Binding TUI: PgUp/PgDn scroll; **Shift+PgUp/PgDn (ESC[5;2~/6;2,
|
|
158
|
+
modifier 2) = setengah halaman; Home/End saat prompt KOSONG = lompat
|
|
159
|
+
baris-teratas/ekor transkrip (baris berisi = editing awal/akhir baris;
|
|
160
|
+
dropdown terbuka = jalur engine)**; Up/Down histori; Tab/Shift+Tab mode;
|
|
161
|
+
Ctrl+O/T compact/thinking; Ctrl+D baris-kosong keluar; Esc/Ctrl+C =
|
|
162
|
+
batal input / abort turn (busy: SEMUA input dibekukan kecuali abort dan
|
|
163
|
+
scroll — Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll
|
|
164
|
+
selalu lolos agar turn bisa dibatalkan tanpa kill -9; abort pertama
|
|
165
|
+
menampilkan status `Stopping` + hint keluar sekali, abort kedua dalam
|
|
166
|
+
1,5 detik menutup sesi). Baris kosong menampilkan placeholder +
|
|
167
|
+
cara keluar; scroll ke atas + stream masuk = indikator `↓ N baris baru`.
|
|
168
|
+
15. (Dihapus bersama jendela info — nomor dipertahankan.)
|
|
169
|
+
16. Popup komposit: region tanpa clear + union-clear anti-hantu + clearRegion
|
|
170
|
+
saat tutup + suspend/resume berpasangan; layar tak mampu = tolak bersuara
|
|
171
|
+
+ batal.
|
|
172
|
+
17. Transkrip append-only di memori (cap 5000), viewport ikut ekor otomatis;
|
|
173
|
+
ketikan baru kembali ke ekor; stream turn TIDAK merampas posisi baca;
|
|
174
|
+
repaint live coalesce 30ms dan clock activity 200ms (layar tak buta
|
|
175
|
+
saat turn). Proyeksi
|
|
176
|
+
presentasi: baris running di-pin dari snapshot, elapsed tampil setelah
|
|
177
|
+
≥2s, status tool final memakai glyph + kata
|
|
178
|
+
(`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan
|
|
179
|
+
grup anak mengikuti model, serta ringkasan turn masuk sebagai system
|
|
180
|
+
entry.
|
|
181
|
+
|
|
182
|
+
18. Prompt multiline (Ctrl+J newline), histori memori-sesi (tak persist ke
|
|
183
|
+
berkas histori lama).
|
|
184
|
+
19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
|
|
185
|
+
20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 76,
|
|
186
|
+
form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
|
|
187
|
+
selalu tampil.
|
|
188
|
+
21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
|
|
189
|
+
select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
|
|
190
|
+
luar kotak. Esc dua-tahap: tekan-1 KEMBALIKAN nilai bawaan field
|
|
191
|
+
(prefill/edit tak hilang sekali tekan), tekan-2 batal. Idle guard
|
|
192
|
+
dua-tahap (temuan audit TUI-004): 80 dtk tanpa input = peringatan statis
|
|
193
|
+
di footer form ("batal dalam 10 dtk" — bukan countdown hidup), 10 dtk
|
|
194
|
+
berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
|
|
195
|
+
ketikan apa pun me-reset kedua timer.
|
|
196
|
+
22. Thinking terlihat: minimized = penanda `… thinking` + isi di `/expand`;
|
|
197
|
+
expanded = alir redup; fase berakhir = commit (tak ada thinking yatim).
|
|
198
|
+
23. Approval & ask_user tercatat di transkrip (pertanyaan + keputusan) dan
|
|
199
|
+
terlihat sebelum menjawab; non-TTY = deny/null fail-closed; stdout
|
|
200
|
+
di-pipe tanpa sink TUI = deny/null (prompt tak terlihat + mencemari
|
|
201
|
+
output program bila dipaksa).
|
|
202
|
+
24. `/expand` query Content Store (buka-ulang identik, tidak sekali-habis);
|
|
203
|
+
dengan id membaca satu tool, tanpa id membaca seluruh entry store yang
|
|
204
|
+
masih hidup; miss → durable sqlite → penanda retensi. Pilihan `/model`
|
|
205
|
+
persist antar sesi + struk `model: x`; `/help` ringkas (penuh via
|
|
206
|
+
`/help tombol`).
|
|
207
|
+
25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
|
|
208
|
+
backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
|
|
209
|
+
(`↑↓`, pgup/pgdn, home/end) di semua popup; hint footer akurat
|
|
210
|
+
per permukaan; kursor diparkir di semua permukaan.
|
|
211
|
+
26. i18n dwibahasa: semua string user-visible lewat `t()`; id kunci = en
|
|
212
|
+
(tsc mengawal); fallback kunci hilang → en; prioritas sesi > env >
|
|
213
|
+
state.json > locale OS > en (di OS: `LC_ALL` > `LANG`, string kosong
|
|
214
|
+
diabaikan); literal Indonesia hardcode dilarang.
|
|
215
|
+
31. Sinyal fatal saat TUI hidup (SIGTERM/SIGHUP): restore terminal dulu
|
|
216
|
+
(alt-screen exit + raw mode pulih + handler exit sinkron) lalu exit
|
|
217
|
+
`128+n` (143/129). Pasangan ketat per-run — handler dipasang di
|
|
218
|
+
`run()` dan dilepas di cleanup; tanpa sesi TUI, sinyal tak disentuh.
|
|
219
|
+
(Temuan audit TUI-001: handler `exit` Node tak jalan pada SIGTERM
|
|
220
|
+
default — terminal tertinggal alt-screen + raw.)
|
|
221
|
+
32. Proyeksi Presentasi V2.1 TUI memakai snapshot struktural dari composition
|
|
222
|
+
root, bukan parser string. `view`, cap, scroll, approval, transient,
|
|
223
|
+
resize, cursor, dan PTY path tetap memakai kontrak lama.
|
|
224
|
+
33. Proyeksi linear dan ACP memakai snapshot/event presentasi yang sama:
|
|
225
|
+
linear menambahkan status/duration/receipt/retry tanpa mengubah
|
|
226
|
+
stdout/stderr split, sedangkan ACP mengirim lifecycle `turn.*`, `tool.*`,
|
|
227
|
+
dan `approval.*` terstruktur plus teks delta. Exit code, pipe safety, dan
|
|
228
|
+
determinisme non-TTY tetap sama.
|
|
229
|
+
|
|
230
|
+
27. Painter transient stderr (spinner setup/cek-update, garis status turn)
|
|
231
|
+
DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
|
|
232
|
+
(`src/ui/runtime/statusline.ts`) membisukan `paintWrite` (nol byte + baris
|
|
233
|
+
painter dibersihkan sekali saat layar mengambil alih), nested dihitung,
|
|
234
|
+
release idempoten. Pemegang: `askLine`/`askSecret`/`runPicker` (raw-mode)
|
|
235
|
+
dan `openAltScreen` (alt-screen, release di `close()`). Tanpa ini tick
|
|
236
|
+
`\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
|
|
237
|
+
Menyiapkan sesi…").
|
|
238
|
+
28. Kontrak exit code: **0** sukses/help, **1** gagal runtime/lookup, **2**
|
|
239
|
+
salah pakai (argumen hilang/malformed, subcommand asing). Flag sebagai
|
|
240
|
+
positional id = salah pakai (exit 2). `exec --json` yang gagal di fase
|
|
241
|
+
setup (tanpa provider) TETAP memancarkan satu baris `{"type":"summary",
|
|
242
|
+
"ok":false,…}` (di-scrub) di stdout — pipeline CI tak pernah menerima
|
|
243
|
+
stream kosong; jalur manusia (stderr + exit 1) tidak berubah. Flag `exec`
|
|
244
|
+
diparse dari argv SESUDAH token subcommand.
|
|
245
|
+
29. `minicode acp` = server JSON-RPC stdio satu-JSON-per-baris untuk IDE
|
|
246
|
+
(subset: `initialize`/`run`/`cancel`/`shutdown`; BUKAN klaim ACP penuh):
|
|
247
|
+
stdout murni mesin (semua di-scrub), diagnostik manusia ke stderr,
|
|
248
|
+
approval `deny-headless`, satu run dalam satu waktu, shutdown/EOF = exit 0.
|
|
249
|
+
30. `askLine` (input inline: dropdown `/`, prompt wizard/`ask_user`)
|
|
250
|
+
menginvalidasi jangkar relatifnya saat geometri terminal berubah: render
|
|
251
|
+
pertama sesudah `columns`/`rows` berbeda dari geometri render TERAKHIR
|
|
252
|
+
me-reset `prevRows`/`prevInputRows`/`prevCursorRow` lalu menggambar dari
|
|
253
|
+
kursor saat ini (`lastGeoCols/Rows` di `src/ui/input/input.ts`). Jangkar
|
|
254
|
+
basi pasca-reflow mendarat di baris salah — menimpa area output dan
|
|
255
|
+
menghapus baris yang salah (temuan snap kiri/kanan). SENGAJA tanpa
|
|
256
|
+
listener `resize` baru (frame basi cukup ditimpa render berikutnya), dan
|
|
257
|
+
`printedW` tidak ikut di-reset — nilainya konservatif; dikosongkan justru
|
|
258
|
+
membiarkan ekor lama.
|
|
259
|
+
|
|
260
|
+
## Grammar (ringkas)
|
|
261
|
+
|
|
262
|
+
prompt `minicode ›` (+ placeholder & cara keluar saat kosong; dropdown `/`
|
|
263
|
+
berbingkai di atasnya) · status bar = 1 baris · ledger tool
|
|
264
|
+
` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
|
|
265
|
+
kegagalan · thinking: `… thinking` / alir redup · popup: konten redup di
|
|
266
|
+
belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
|
|
267
|
+
`/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
|
|
268
|
+
Projection V2: `› name target … running`, ledger status ber-glyph/kata,
|
|
269
|
+
retry/grup anak, ringkasan turn, dan marker evict sesuai flag ·
|
|
270
|
+
|
|
271
|
+
`Ctrl+C`/`Esc` saat turn = abort (+ hint sekali); busy = input beku total ·
|
|
272
|
+
PgUp/PgDn = scroll, Shift+PgUp/PgDn = setengah halaman, Home/End (prompt
|
|
273
|
+
kosong) = lompat top/ekor · indikator `↓ N baris baru` · tab dihitung 8 kolom (batas atas stop
|
|
274
|
+
terminal — tak pernah undercount) · C1/bidi/tag dibuang dari teks
|
|
275
|
+
tak-terpercaya (sanitasi) · truncate/chunk hanya menyalin SGR (non-SGR
|
|
276
|
+
dibuang) · penanda `(aktif)` di luar budget truncasi (tak termakan URL
|
|
277
|
+
panjang).
|
|
278
|
+
|
|
279
|
+
## Residual risk (DISENGAJA — jangan "perbaiki" tanpa keputusan)
|
|
280
|
+
|
|
281
|
+
1. Foreign partial stderr write tanpa newline (non-interaktif).
|
|
282
|
+
2. `kill -9` di tengah sesi: ketik `reset` (pola standar). SIGTERM/SIGHUP
|
|
283
|
+
SUDAH di-handle (I31 — restore + exit 128+n); hanya kill -9/terminal
|
|
284
|
+
close yang masih menyisakan alt-screen.
|
|
285
|
+
3. Transkrip TUI hilang saat quit (disengaja — TUI fullscreen).
|
|
286
|
+
4. Terminal purba tanpa alternate screen: pesan satu baris + keluar (bukan error).
|
|
287
|
+
5. Approval saat user scroll ke atas: blok tercatat di ekor (tak terlihat
|
|
288
|
+
sampai PgDn), tapi prompt jawaban + bell selalu terlihat di bawah.
|
|
289
|
+
6. Area yang dibuka kembali saat kotak menyusut = kosong (bukan transkrip
|
|
290
|
+
di belakangnya) sampai popup tutup + repaint penuh.
|
|
291
|
+
|
|
292
|
+
## Peta proteksi (test → invariant)
|
|
293
|
+
|
|
294
|
+
- `test/tui-app.test.ts` — I1/I14/I17-I20 (boot/exit pairing, transcript viewport,
|
|
295
|
+
scroll + indikator, prompt + placeholder, status bar, quit, suspend/resume,
|
|
296
|
+
busy-freeze, live repaint; I14: abort/scroll lolos saat menciut; I17: kunci
|
|
297
|
+
posisi baca + basis monotonik).
|
|
298
|
+
- `test/screen-buffer.test.ts` — parser frame harness (unit).
|
|
299
|
+
- `test/tui-transcript.test.ts` — I7/I12/I17/I22/I24 (ledger, cap, viewport,
|
|
300
|
+
thinking, buffer /expand; total() monotonik kebal evict).
|
|
301
|
+
- `test/presentation-projections.test.ts` — I12/I17/I26/I32 (projection
|
|
302
|
+
snapshot, running/elapsed, status terminal, retry/child grouping, summary,
|
|
303
|
+
marker evict, dan parity flag OFF).
|
|
304
|
+
- `test/presentation-linear-acp.test.ts` — I2/I6/I28/I33 (linear projection
|
|
305
|
+
status/duration/receipt dan lifecycle ACP terstruktur).
|
|
306
|
+
|
|
307
|
+
- `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
|
|
308
|
+
anti-hantu).
|
|
309
|
+
- `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
|
|
310
|
+
Esc-1 kembalikan prefill, Esc-2 batal).
|
|
311
|
+
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
312
|
+
stdout-pipe tanpa sink = deny).
|
|
313
|
+
- `test/footer-render.test.ts` — I13.
|
|
314
|
+
- `test/terminal-contract.test.ts` — I2/I3/I5/I7/I8/I9/I12.
|
|
315
|
+
- `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
|
|
316
|
+
picker/askLine, nesting, delayMs).
|
|
317
|
+
- `test/statusline-bun-guard.test.ts` — I4/I5.
|
|
318
|
+
- `test/turn-status.test.ts` — I5.
|
|
319
|
+
- `test/tui-format.test.ts` — I2/I7/I8 (preview arg sanitasi satu-baris).
|
|
320
|
+
- `test/theme.test.ts` — I6 (strip DCS/APC/PM/SOS + final CSI non-huruf).
|
|
321
|
+
- `test/ansi-fragmentation.test.ts` — I6/I8.
|
|
322
|
+
- `test/non-tty-output.test.ts` — I6.
|
|
323
|
+
- `test/thinking-truncation.test.ts` — I12.
|
|
324
|
+
- `test/ui-combined.test.ts` — DIHAPUS bersama chrome.
|
|
325
|
+
- `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
|
|
326
|
+
`test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
|
|
327
|
+
- `test/cli-commands.test.ts` — /status cetak, /sessions popup.
|
|
328
|
+
- `test/screen.test.ts` — I16 (pairing + paintRegion).
|
|
329
|
+
- `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box).
|
|
330
|
+
- `test/tui-overlay.test.ts` — I11/I16 (popup region + gate layar).
|
|
331
|
+
- `test/ui-boundary.test.ts` — I1/I3 (src/ui tak impor keluar).
|
|
332
|
+
- `test/i18n.test.ts` — I26 (resolusi, fallback, interpolasi, kelengkapan;
|
|
333
|
+
LC_ALL > LANG, string kosong diabaikan).
|
|
334
|
+
- `test/i18n-hardcode.test.ts` — I26 (lexer sadar-state: tanpa literal
|
|
335
|
+
Indonesia di luar kamus; kontrol positif id.ts kena, negatif en.ts bersih).
|
|
336
|
+
- `test/tui-lang.test.ts` — I26/I24 (/lang end-to-end, /help satu sumber).
|
|
337
|
+
- `test/cli-help-language.test.ts` — I26/I25 (label en, kelengkapan /help).
|
|
338
|
+
- `test/tui-geometry.test.ts` — I20/I25 (lebar tetap per permukaan, step
|
|
339
|
+
wizard, form error).
|
|
340
|
+
- `test/sanitize.test.ts` — I2 (C1/bidi/tag dibuang, ZWJ dipertahankan;
|
|
341
|
+
NO_COLOR menang di cleanUntrusted).
|
|
342
|
+
- `test/width.test.ts` — I2/I7 (tab 8 kolom; truncate/chunk hanya-SGR +
|
|
343
|
+
auto-reset; chunk(0) kosong).
|
|
344
|
+
- `test/exit-codes.test.ts` — I28 (0/1/2 di semua handler; lookup tetap 1;
|
|
345
|
+
hermetic subprocess).
|
|
346
|
+
- `test/exec-json-envelope.test.ts` — I28 (summary ok:false di stdout saat
|
|
347
|
+
setup gagal; jalur manusia tak berubah).
|
|
348
|
+
- `test/acp.test.ts` — I29 (parser/framing/params + smoke spawn stdio:
|
|
349
|
+
initialize→shutdown exit 0, tanpa provider).
|
|
350
|
+
- `test/input-resize.test.ts` — I30 (gagal di kode lama: CUP `\x1b[1A` ke
|
|
351
|
+
jangkar basi sesudah resize; multiline, dropdown terbuka, resize ganda,
|
|
352
|
+
resize cepat ×10 → nilai submit utuh).
|
|
353
|
+
- `test/tui-diff.test.ts` — I2/I7 (path & isi disanitasi).
|
|
354
|
+
- `test/highlight.test.ts` — I2/I8 (CR dibuang; escape dibuang di hulu).
|
|
355
|
+
- `test/tui-theme-highlight.test.ts` — I2 (section satu-baris; markdown
|
|
356
|
+
buang escape di hulu).
|
|
357
|
+
- `test/provider-manager-flows.test.ts` — I21 (Ctrl+C dua-tahap revert
|
|
358
|
+
prefill; penanda aktif anti-truncasi).
|
|
359
|
+
- `test/tui-signal.test.ts` — I31 (SIGTERM→143, SIGHUP→129: alt-screen exit
|
|
360
|
+
+ raw mode pulih; handler dilepas saat quit — pasangan ketat; tanpa
|
|
361
|
+
`run()` sinyal tak di-intercept).
|
|
362
|
+
- `test/tui-audit-fixes.test.ts` — I14 (Home/End jump top/tail saat prompt
|
|
363
|
+
kosong + baris berisi tetap editing; Shift+PgUp/PgDn half-page + dekode
|
|
364
|
+
ESC[5;2~; hint abort pertama), I13 (MINICODE_MOTION=0: spark statis,
|
|
365
|
+
env dibaca saat dipakai), I25 (kursor CUP parkir di dalam blok ?2026 yang
|
|
366
|
+
sama), I21 (konstanta idle form 80+10 dtk + teks peringatan).
|
|
367
|
+
- `test/pty.test.ts` — I17/I31/I28 via BYTE STREAM NYATA (harness PTY
|
|
368
|
+
`test/helpers/pty-harness.ts`, CLI di pseudo-terminal sesungguhan +
|
|
369
|
+
provider fake hermetic): boot → ?1049h + prompt, turn penuh end-to-end,
|
|
370
|
+
SIGTERM → restore + exit 143 (POSIX), resize → repaint, exec --json
|
|
371
|
+
bersih tanpa ANSI. Platform tak mampu (ConPTY rusak) = SKIP beralasan,
|
|
372
|
+
bukan hijau palsu.
|