minicode-ai 0.14.1 → 0.14.4
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/README.md +34 -178
- package/cli/args.ts +10 -18
- package/cli/auto-update.ts +32 -2
- package/cli/commands/acp.ts +20 -27
- package/cli/commands/daemon.ts +6 -7
- package/cli/commands/exec.ts +12 -10
- package/cli/commands.ts +6 -9
- package/cli/index.ts +40 -17
- package/cli/provider-manager.ts +1 -3
- package/cli/setup.ts +174 -145
- package/cli/tui.ts +33 -38
- package/docs/CONTROL-PLANE-MAP.md +145 -0
- package/docs/OUTPUT_EVENT_MODEL.md +1 -1
- package/docs/OUTPUT_PROTOCOL_SPEC.md +8 -2
- package/docs/OUTPUT_RENDERING_SPEC.md +35 -6
- package/docs/OUTPUT_UX_RULES.md +1 -1
- package/docs/README.md +14 -102
- package/docs/SUMMARY.md +53 -0
- package/docs/TERMINAL_CONTRACT.md +136 -77
- package/docs/UI_RENDER_PIPELINE.md +204 -0
- package/docs/agents.md +5 -5
- package/docs/architecture.md +23 -12
- package/docs/choosing-mode.md +7 -7
- package/docs/cli.md +22 -29
- package/docs/concepts.md +1 -1
- package/docs/config.md +10 -5
- package/docs/contributing.md +6 -6
- package/docs/environment.md +3 -1
- package/docs/exec.md +5 -5
- package/docs/getting-started.md +14 -12
- package/docs/glossary.md +9 -7
- package/docs/mcp-lsp.md +1 -1
- package/docs/memory-sessions.md +7 -5
- package/docs/policy-sandbox.md +23 -15
- package/docs/quickstart.md +2 -2
- package/docs/repl.md +4 -3
- package/docs/security-model.md +16 -17
- package/docs/security.md +15 -30
- package/docs/skills.md +1 -1
- package/docs/tools.md +6 -6
- package/docs/verify-benchmark.md +16 -0
- package/package.json +5 -5
- package/scripts/vendor-overlays/minicode-context.patch +109 -0
- package/src/app/mentions.ts +4 -3
- package/src/app/provider-layer.ts +13 -1
- package/src/app/session.ts +229 -22
- package/src/app/tool-layer.ts +6 -0
- package/src/config.ts +30 -3
- package/src/constants.ts +19 -0
- package/src/daemon/control.ts +1 -1
- package/src/lib/git-hardening.ts +27 -22
- package/src/lib/safe-open.ts +73 -19
- package/src/lib/trusted-exec.ts +7 -4
- package/src/mcp/client.ts +34 -9
- package/src/mcp/server.ts +2 -3
- package/src/mcp/transport.ts +96 -42
- package/src/memory/files.ts +15 -4
- package/src/memory/vector.ts +5 -1
- package/src/policy/compaction.ts +272 -16
- package/src/policy/context-window.ts +73 -0
- package/src/policy/context.ts +76 -16
- package/src/policy/ratelimit.ts +47 -18
- package/src/policy/tool-contract.ts +4 -10
- package/src/policy/update-check.ts +83 -6
- package/src/policy/usage.ts +31 -14
- package/src/policy/work-mode.ts +1 -1
- package/src/presentation/adapter.ts +64 -2
- package/src/presentation/events.ts +6 -0
- package/src/presentation/model.ts +1 -0
- package/src/presentation/projection.ts +2 -0
- package/src/presentation/reducer.ts +1 -0
- package/src/providers/anthropic.ts +52 -19
- package/src/providers/guards.ts +158 -16
- package/src/providers/provision.ts +12 -3
- package/src/providers/responses.ts +61 -23
- package/src/providers/router.ts +56 -23
- package/src/providers/sse-bounds.ts +170 -0
- package/src/repo/repomap.ts +10 -11
- package/src/runtime/execution-backend.ts +7 -8
- package/src/sandbox/docker.ts +113 -9
- package/src/session/checkpoint.ts +9 -2
- package/src/session/context-projection.ts +14 -0
- package/src/session/context-selector.ts +58 -20
- package/src/session/persistence.ts +6 -3
- package/src/session/verification.ts +55 -16
- package/src/skills/loader.ts +16 -3
- package/src/task/model.ts +21 -70
- package/src/tools/bash.ts +6 -3
- package/src/tools/code_run.ts +6 -5
- package/src/tools/context.ts +8 -0
- package/src/tools/delete_file.ts +2 -1
- package/src/tools/edit.ts +2 -1
- package/src/tools/git.ts +128 -54
- package/src/tools/glob.ts +2 -1
- package/src/tools/grep.ts +31 -6
- package/src/tools/lsp.ts +5 -4
- package/src/tools/mcp_call.ts +3 -1
- package/src/tools/memory.ts +175 -180
- package/src/tools/move_file.ts +2 -1
- package/src/tools/patch.ts +2 -1
- package/src/tools/read_file.ts +94 -1
- package/src/tools/read_image.ts +2 -1
- package/src/tools/task.ts +9 -1
- package/src/tools/todo.ts +4 -5
- package/src/tools/web_fetch.ts +28 -12
- package/src/tools/web_search.ts +28 -9
- package/src/tools/write_file.ts +2 -1
- package/src/ui/assistant/simple.ts +72 -3
- package/src/ui/footer.ts +131 -66
- package/src/ui/i18n/en.ts +3 -11
- package/src/ui/i18n/id.ts +3 -11
- package/src/ui/input/input.ts +2 -3
- package/src/ui/input/prompt-engine.ts +2 -5
- package/src/ui/render/width.ts +107 -79
- package/src/ui/runtime/screen.ts +49 -37
- package/src/ui/screens/model-manager.ts +3 -10
- package/src/ui/screens/picker.ts +23 -40
- package/src/ui/screens/provider-manager.ts +12 -33
- package/src/ui/screens/wizard.ts +0 -1
- package/src/ui/tui/app.ts +265 -211
- package/src/ui/tui/transcript.ts +87 -8
- package/vendor/minicore/VENDOR.md +9 -5
- package/vendor/minicore/src/core/loop.ts +47 -12
- package/vendor/minicore/src/core/provider.ts +4 -0
- package/vendor/minicore/src/core/session.ts +14 -1
- package/CHANGELOG.md +0 -1185
- package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
- package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
- package/docs/PLAN_UIUX_V6.md +0 -209
- package/docs/changelog.md +0 -3
|
@@ -1,13 +1,38 @@
|
|
|
1
|
-
# Kontrak Terminal MiniCode (TUI fullscreen — v7.
|
|
2
|
-
|
|
3
|
-
Perubahan v7.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
1
|
+
# Kontrak Terminal MiniCode (TUI fullscreen — v7.9, 2026-11-07)
|
|
2
|
+
|
|
3
|
+
Perubahan v7.9: input command slash tidak ditambahkan sebagai pesan transkrip;
|
|
4
|
+
aksi popup provider/model/sesi dan toggle UI tidak meninggalkan riwayat status
|
|
5
|
+
di transkrip. Output command yang informatif, error, dan hasil prompt model tetap
|
|
6
|
+
tampil. Jawaban model membuang blank line di tepi dan merapatkan jeda berulang
|
|
7
|
+
di luar code fence; isi code fence tetap literal.
|
|
8
|
+
|
|
9
|
+
Perubahan v7.8: sesi baru dan sesi legacy tanpa WorkMode mulai di `Discuss`;
|
|
10
|
+
operator hanya dapat memilih `Discuss`, `Plan`, atau `Build`. Permission Mode
|
|
11
|
+
awal `Auto` dan kontrolnya hanya `Auto`/`Ask`. Dropdown `/` menampilkan nama
|
|
12
|
+
command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
|
|
13
|
+
model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
|
|
14
|
+
ringkas.
|
|
15
|
+
|
|
16
|
+
Perubahan v7.7: footer memakai label title case `Work Mode: Build` di sisi kiri
|
|
17
|
+
dan `Permission Mode: Auto` di sisi kanan dekat pemakaian konteks. Nilai kedua
|
|
18
|
+
mode memakai warna berbeda; pada terminal sempit label dipadatkan sebelum nilai
|
|
19
|
+
mode atau konteks dihilangkan.
|
|
20
|
+
|
|
21
|
+
Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
|
|
22
|
+
`BUILD` untuk identitas runtime `EXECUTE`, footer dua sumbu yang selalu tampil,
|
|
23
|
+
dan pintasan `Tab`/`Shift+Tab` untuk WorkMode/PermissionMode.
|
|
24
|
+
|
|
25
|
+
Perubahan v7.5: kepemilikan frame stdout interaktif diperjelas; cleanup `TuiApp.run()`
|
|
26
|
+
berpasangan melalui `finally`; gap proteksi teardown, startup, spacer, layar kecil,
|
|
27
|
+
dan writer ownership ditutup dengan test app/subprocess/PTY.
|
|
28
|
+
|
|
29
|
+
Perubahan v7.4 (P12 S2.2 WorkMode): invarian I35 — WorkMode runtime
|
|
30
|
+
`DISCUSS`/`PLAN`/`EXECUTE` terpisah dari PermissionMode. Nama produk `BUILD`
|
|
31
|
+
adalah alias input dan label tampilan untuk identitas runtime `EXECUTE`; nilai
|
|
32
|
+
persisten tetap `EXECUTE`. Command `/work-mode <DISCUSS|PLAN|BUILD>` juga
|
|
33
|
+
menerima `EXECUTE` sebagai alias kompatibilitas. Footer menampilkan pasangan
|
|
34
|
+
`<WorkMode>·<PermissionMode>`; defaultnya `BUILD · AUTO`. `Tab` memutar WorkMode,
|
|
35
|
+
sedangkan `Shift+Tab` dan `/mode` mengubah PermissionMode. Rincian di I35.
|
|
11
36
|
|
|
12
37
|
Perubahan v7.3 (P11 Presentation & UX): invarian baru I34 — subcommand `exec`
|
|
13
38
|
dan `daemon` menerima argv SCOPE dari router (flag global dikenal yang
|
|
@@ -61,7 +86,7 @@ proteksi").
|
|
|
61
86
|
|
|
62
87
|
| Stream | Isi | Catatan |
|
|
63
88
|
|---|---|---|
|
|
64
|
-
| stdout |
|
|
89
|
+
| stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
|
|
65
90
|
| stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error | Boleh transient rendering bila stderr TTY |
|
|
66
91
|
| 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()` |
|
|
67
92
|
|
|
@@ -82,13 +107,16 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
82
107
|
|
|
83
108
|
## Ownership
|
|
84
109
|
|
|
85
|
-
- `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit
|
|
86
|
-
|
|
87
|
-
|
|
110
|
+
- `App` pemilik tunggal layar (alt-screen enter saat start, exit saat quit).
|
|
111
|
+
`TuiApp.run()` melepas listener/timer/subscription, memulihkan raw mode, dan
|
|
112
|
+
menutup layar lewat `finally` idempoten pada jalur sukses maupun exception.
|
|
113
|
+
Hook `process.on("exit")` hanya jaring best-effort terakhir, bukan pengganti
|
|
114
|
+
cleanup lifecycle. Turn berjalan = indikator spark pada status bar.
|
|
88
115
|
- **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
|
|
89
116
|
`process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
|
|
90
117
|
tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
|
|
91
|
-
→ restore terminal (alt-screen exit + raw mode pulih)
|
|
118
|
+
→ restore terminal (alt-screen exit + raw mode pulih) tepat satu kali walau
|
|
119
|
+
handler sinyal terpanggil ulang, lalu
|
|
92
120
|
`process.exit(128+n)`. Pasangan ketat: keduanya dilepas di cleanup `run()` —
|
|
93
121
|
tanpa sesi TUI, sinyal TIDAK di-intercept (perilaku default proses tetap).
|
|
94
122
|
Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
|
|
@@ -129,7 +157,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
129
157
|
atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
|
|
130
158
|
`dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
|
|
131
159
|
sendiri.
|
|
132
|
-
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider
|
|
160
|
+
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 52,
|
|
133
161
|
form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
|
|
134
162
|
Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
|
|
135
163
|
hilang, id selamat).
|
|
@@ -188,8 +216,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
188
216
|
live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
|
|
189
217
|
layout paint tidak boleh memproyeksikan transcript dua kali.
|
|
190
218
|
|
|
191
|
-
13. Status bar: 1 baris dasar (`✦ 00.00.00
|
|
192
|
-
yang sama dengan angka sesi.
|
|
219
|
+
13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
|
|
220
|
+
context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
|
|
221
|
+
Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
|
|
222
|
+
konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
|
|
223
|
+
atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
|
|
224
|
+
menjadi indikator proses hidup;
|
|
193
225
|
timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
|
|
194
226
|
detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
|
|
195
227
|
Reasoning memakai dots `...` → `..` → `.` → `..` →
|
|
@@ -204,7 +236,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
204
236
|
**Shift+PgUp/PgDn (ESC[5;2~/6;2, modifier 2) = setengah halaman; Home/End
|
|
205
237
|
saat prompt KOSONG = lompat baris-teratas/ekor transkrip (baris berisi =
|
|
206
238
|
editing awal/akhir baris; dropdown terbuka = jalur engine)**; Up/Down
|
|
207
|
-
histori; Tab/Shift+Tab
|
|
239
|
+
histori; Tab WorkMode / Shift+Tab PermissionMode; Ctrl+O/T compact/thinking; Ctrl+D baris-kosong
|
|
208
240
|
keluar; Esc membersihkan selection lebih dulu, lalu batal input / abort
|
|
209
241
|
turn (busy: SEMUA input dibekukan kecuali abort, scroll, dan selection —
|
|
210
242
|
Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll selalu lolos
|
|
@@ -227,6 +259,14 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
227
259
|
tetap pada ledger tool, status tool final memakai glyph + kata
|
|
228
260
|
(`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
|
|
229
261
|
anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
|
|
262
|
+
**Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
|
|
263
|
+
`attemptId`. Bila attempt gagal setelah mengirim konten, TUI membuang
|
|
264
|
+
ekor attempt yang belum di-commit dan menambah diagnostic invalidasi.
|
|
265
|
+
Sink linear/pipe bersifat append-only: byte yang sudah ditulis tetap ada,
|
|
266
|
+
sehingga sink wajib menulis marker invalidasi sebelum output attempt
|
|
267
|
+
berikutnya. Konten attempt gagal dikeluarkan dari `/copy`, reasoning
|
|
268
|
+
durable, dan jawaban akhir; usage provider tetap dihitung karena request
|
|
269
|
+
tersebut sudah terjadi.
|
|
230
270
|
**Grup anak (F-AGENT-1):** tool anak yang punya identitas run
|
|
231
271
|
(`childSessionId`/`runId` — dari `ChildSessionLink`) tampil sebagai baris
|
|
232
272
|
run sendiri, diindented `↳ <marker> <tool> <target> <status>` dengan
|
|
@@ -241,7 +281,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
241
281
|
berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
|
|
242
282
|
oldest-to-newest) melalui OSC 52.
|
|
243
283
|
19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
|
|
244
|
-
20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider
|
|
284
|
+
20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 52,
|
|
245
285
|
form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
|
|
246
286
|
selalu tampil.
|
|
247
287
|
21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
|
|
@@ -330,20 +370,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
330
370
|
invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
|
|
331
371
|
35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
|
|
332
372
|
dimensi yang BERJALAN BERSAMA, bukan pengganti:
|
|
333
|
-
**Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
|
|
373
|
+
**Nilai runtime:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
|
|
334
374
|
lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
|
|
335
375
|
(ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
|
|
336
|
-
|
|
337
|
-
ceiling tambahan).
|
|
338
|
-
|
|
339
|
-
**Gerbang penolakan & side-effect ceiling:**
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
376
|
+
pengawasan eksplisit + ekstra rencana bila diizinkan Tool Access Policy) ·
|
|
377
|
+
`EXECUTE` (tanpa ceiling tambahan). Nama produk `BUILD` memetakan ke
|
|
378
|
+
identitas internal `EXECUTE`; sesi baru memakai default `DISCUSS`.
|
|
379
|
+
**Gerbang penolakan & side-effect ceiling:** Tool Access Policy menentukan
|
|
380
|
+
capability yang tersedia; PermissionMode menentukan pengawasan persetujuan;
|
|
381
|
+
WorkMode memasang ceiling tambahan. Irisan ketiganya tidak pernah
|
|
382
|
+
memperluas akses (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
|
|
343
383
|
hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
|
|
344
384
|
ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
|
|
345
385
|
serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
|
|
346
|
-
**Command `/work-mode <DISCUSS|PLAN|
|
|
386
|
+
**Command `/work-mode <DISCUSS|PLAN|BUILD>`:** tiga nilai produk yang dapat
|
|
387
|
+
dipilih operator; `EXECUTE` hanya nama internal dan ditolak sebagai input.
|
|
347
388
|
Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
|
|
348
389
|
kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
|
|
349
390
|
(handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
|
|
@@ -356,42 +397,47 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
356
397
|
**Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
|
|
357
398
|
(`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
|
|
358
399
|
(`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
|
|
359
|
-
sesi (baris legacy tanpa `work_mode` kembali ke default `
|
|
400
|
+
sesi (baris legacy tanpa `work_mode` kembali ke default `DISCUSS`; nilai
|
|
401
|
+
tersimpan `EXECUTE` lama ditampilkan sebagai `BUILD`) dan
|
|
360
402
|
composition root menulis SATU baris stderr human-facing
|
|
361
403
|
(`[resume] WorkMode <MODE> restored from session...` atau notice override/
|
|
362
404
|
legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
|
|
363
405
|
keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
|
|
364
406
|
terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
|
|
365
407
|
**Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
|
|
366
|
-
footer (
|
|
367
|
-
baris stderr human-facing `[work-mode] <MODE>
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
408
|
+
footer (Work Mode kiri; Permission Mode kanan), di one-shot/exec linear
|
|
409
|
+
lewat SATU baris stderr human-facing `[work-mode] <MODE> …`, dan di
|
|
410
|
+
`exec --json` lewat field `summary.workMode` dengan nilai produk `DISCUSS`,
|
|
411
|
+
`PLAN`, atau `BUILD` — bukan teks dekoratif. ACP memakai `params.workMode`
|
|
412
|
+
(terstruktur) dan tak menambah baris
|
|
371
413
|
dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
|
|
372
414
|
vs `/mode`/`--plan`) dan dari status sesi.
|
|
373
|
-
**Pemisahan dari
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
(diskusi/rencana/bebas) dan hanya
|
|
415
|
+
**Pemisahan dari PermissionMode:** `Tab` memutar WorkMode;
|
|
416
|
+
`Shift+Tab` dan `/mode` mengubah PermissionMode. PermissionMode menentukan
|
|
417
|
+
pengawasan persetujuan (`AUTO`/`ASK`) dan Tool Access Policy menentukan
|
|
418
|
+
capability. WorkMode memilih postur (diskusi/rencana/bebas) dan hanya
|
|
419
|
+
mempersempit akses.
|
|
377
420
|
**Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
|
|
378
|
-
**per pemanggilan** dengan WorkMode **AKTIF
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
`
|
|
386
|
-
|
|
421
|
+
**per pemanggilan** dengan WorkMode dan PermissionMode **AKTIF**. Hooks
|
|
422
|
+
ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
|
|
423
|
+
`plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
|
|
424
|
+
PermissionMode AUTO/ASK.
|
|
425
|
+
**Footer:** Work Mode tampil di kiri dengan label produk `Work Mode: Build`,
|
|
426
|
+
`Work Mode: Plan`, atau `Work Mode: Discuss`; alias internal `EXECUTE` tidak
|
|
427
|
+
ditampilkan. Permission Mode tampil di kanan dekat token konteks sebagai
|
|
428
|
+
`Permission Mode: Auto` atau `Permission Mode: Ask`. Nilai Work Mode memakai
|
|
429
|
+
warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu mudah
|
|
430
|
+
dibedakan. Pada terminal sempit label dipadatkan, tetapi kedua nilai mode
|
|
431
|
+
dipertahankan selama lebar memungkinkan.
|
|
387
432
|
|
|
388
433
|
## Grammar (ringkas)
|
|
389
434
|
|
|
390
435
|
prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
|
|
391
436
|
berbingkai di atasnya) ·
|
|
392
|
-
status bar `✦ 00.00.00
|
|
393
|
-
menit mulai terang di 60 dtk, jam di 1
|
|
394
|
-
|
|
437
|
+
status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`
|
|
438
|
+
(timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
|
|
439
|
+
jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
|
|
440
|
+
dipadatkan pada terminal sempit)
|
|
395
441
|
+ satu spacer sebelum footer · ledger tool
|
|
396
442
|
` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
|
|
397
443
|
kegagalan · pesan error TUI = formatter kanonik (`formatError`,
|
|
@@ -445,7 +491,7 @@ panjang).
|
|
|
445
491
|
> **benar-benar di-assert** oleh test yang disebut. Kehadiran nama file test
|
|
446
492
|
> bukan bukti klaim. Baris yang hanya "nominal" (test ada, tapi assertion-nya
|
|
447
493
|
> tak menyentuh perilaku yang diklaim) dipindah ke bagian
|
|
448
|
-
> [Gap proteksi](#
|
|
494
|
+
> [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
|
|
449
495
|
> dipoles dengan mengganti kata-kata.
|
|
450
496
|
|
|
451
497
|
- `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (boot/exit pairing, transcript
|
|
@@ -506,14 +552,14 @@ panjang).
|
|
|
506
552
|
Esc-1 kembalikan prefill, Esc-2 batal).
|
|
507
553
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
508
554
|
stdout-pipe tanpa sink = deny).
|
|
509
|
-
- `test/footer-render.test.ts` — I13 (
|
|
555
|
+
- `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit).
|
|
510
556
|
- `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
|
|
511
|
-
dievaluasi per pemanggilan tool; transisi EXECUTE↔DISCUSS↔PLAN pada sesi
|
|
557
|
+
dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
|
|
512
558
|
yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
|
|
513
559
|
WorkMode aktif; delegasi mewarisi WorkMode parent terbaru; argumen
|
|
514
560
|
delegasi tak bisa menaikkan WorkMode; `/work-mode` end-to-end lewat TUI
|
|
515
|
-
termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode;
|
|
516
|
-
|
|
561
|
+
termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; footer
|
|
562
|
+
memakai label title case; Tab mengubah WorkMode dan Shift+Tab tidak).
|
|
517
563
|
- `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
|
|
518
564
|
handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
|
|
519
565
|
`web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
|
|
@@ -528,18 +574,23 @@ panjang).
|
|
|
528
574
|
- `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
|
|
529
575
|
tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
|
|
530
576
|
- `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
|
|
531
|
-
resume > default
|
|
577
|
+
resume > default DISCUSS; nilai invalid → DISCUSS + peringatan; input operator
|
|
578
|
+
hanya DISCUSS/PLAN/BUILD; `--verify`
|
|
532
579
|
ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
|
|
533
580
|
`workMode` parity).
|
|
534
|
-
- `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
|
|
535
|
-
editing/busy, dots clock, timer, cursor, resize, popup
|
|
536
|
-
|
|
537
|
-
|
|
581
|
+
- `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I14/I17 (composer
|
|
582
|
+
editing/busy, dots clock, timer, cursor, resize, popup; teardown saat initial,
|
|
583
|
+
frame, event/timer, dan resize repaint gagal; abort/scroll saat layar menciut;
|
|
584
|
+
spacer composer-footer).
|
|
538
585
|
- `test/markdown-table.test.ts` — I8/I11 (pipe-table parser, streaming
|
|
539
586
|
parity, ANSI/CJK width, TTY/non-TTY, TUI resize, machine-output policy).
|
|
540
587
|
- `test/terminal-contract.test.ts` — I2/I3/I7/I8/I9 (split stdout/stderr,
|
|
541
588
|
kepemilikan layar tunggal, ledger satu baris per tool, streaming tanpa
|
|
542
589
|
duplikasi, foreign writer boleh mentah).
|
|
590
|
+
- `test/provider-retry-output.test.ts`, `test/tui-transcript.test.ts`, dan
|
|
591
|
+
`test/presentation-events.test.ts` — invalidasi attempt provider gagal;
|
|
592
|
+
TUI/transkrip/history/`/copy` tidak menggabungkan teks gagal dengan jawaban
|
|
593
|
+
final, sementara sink linear memberi marker dan usage tetap tercatat.
|
|
543
594
|
- `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
|
|
544
595
|
picker/askLine, nesting, delayMs).
|
|
545
596
|
- `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
|
|
@@ -563,7 +614,12 @@ panjang).
|
|
|
563
614
|
- `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
|
|
564
615
|
`test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
|
|
565
616
|
- `test/cli-commands.test.ts` — /status cetak, /sessions popup.
|
|
566
|
-
- `test/screen.test.ts` — I16 (pairing + paintRegion
|
|
617
|
+
- `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
|
|
618
|
+
mencoba memulihkan alt-screen dan reset region).
|
|
619
|
+
- `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
|
|
620
|
+
yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
|
|
621
|
+
- `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
|
|
622
|
+
diagnostik stderr, stdout kosong, exit 1, provider tidak dipanggil).
|
|
567
623
|
- `test/dialog.test.ts` — I11/I16/I20 (geometri, backdrop, box).
|
|
568
624
|
- `test/tui-overlay.test.ts` — I11/I16 (popup region + gate layar).
|
|
569
625
|
- `test/ui-boundary.test.ts` — I1/I3 (src/ui tak impor keluar).
|
|
@@ -579,8 +635,9 @@ panjang).
|
|
|
579
635
|
wizard, form error).
|
|
580
636
|
- `test/sanitize.test.ts` — I2 (C1/bidi/tag dibuang, ZWJ dipertahankan;
|
|
581
637
|
NO_COLOR menang di cleanUntrusted).
|
|
582
|
-
- `test/width.test.ts` — I2/I7 (
|
|
583
|
-
|
|
638
|
+
- `test/width.test.ts` — I2/I7 + UI-RENDER-01 (VS16, skin tone, ZWJ, regional
|
|
639
|
+
indicator, keycap, combining mark; truncate/chunk tidak memecah grapheme;
|
|
640
|
+
tab 8 kolom; hanya-SGR + auto-reset; chunk(0) kosong).
|
|
584
641
|
- `test/exit-codes.test.ts` — I28 (0/1/2 di semua handler; lookup tetap 1;
|
|
585
642
|
hermetic subprocess).
|
|
586
643
|
- `test/exec-json-envelope.test.ts` — I28 (summary ok:false di stdout saat
|
|
@@ -608,12 +665,13 @@ panjang).
|
|
|
608
665
|
ESC[5;2~; hint abort pertama), I13 (MINICODE_MOTION=0: spark statis,
|
|
609
666
|
env dibaca saat dipakai), I25 (kursor CUP parkir di dalam blok ?2026 yang
|
|
610
667
|
sama), I21 (konstanta idle form 80+10 dtk + teks peringatan).
|
|
611
|
-
- `test/pty.test.ts` — I13/I17/I31/I28 via BYTE STREAM NYATA
|
|
612
|
-
`test/helpers/pty-harness.ts`, CLI di pseudo-terminal
|
|
613
|
-
provider fake hermetic): boot → ?1049h + timer idle,
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
668
|
+
- `test/pty.test.ts` — I13/I17/I31/I28 + UI-RENDER-01 via BYTE STREAM NYATA
|
|
669
|
+
(harness PTY `test/helpers/pty-harness.ts`, CLI di pseudo-terminal
|
|
670
|
+
sesungguhan + provider fake hermetic): boot → ?1049h + timer idle, terminal
|
|
671
|
+
terlalu kecil menolak alt-screen, turn penuh, teks Unicode kompleks pada
|
|
672
|
+
frame produksi, drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse
|
|
673
|
+
dihitung dari LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM →
|
|
674
|
+
restore + exit 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
|
|
617
675
|
sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
|
|
618
676
|
bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
|
|
619
677
|
Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
|
|
@@ -629,18 +687,19 @@ panjang).
|
|
|
629
687
|
skip senyap. Parser SGR dan selection SGR tetap terverifikasi terpisah di
|
|
630
688
|
`test/prompt-engine.test.ts` dan `test/tui-app.test.ts` (fake TTY).
|
|
631
689
|
|
|
632
|
-
###
|
|
690
|
+
### Peta proteksi dan gap tersisa
|
|
633
691
|
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
kata-kata di sini TIDAK menutup gap.
|
|
692
|
+
Baris berstatus "ditutup" menunjukkan bukti yang tersedia saat ini. Gap tersisa
|
|
693
|
+
tetap UNVERIFIED; keberadaan implementasi saja bukan bukti UAT.
|
|
637
694
|
|
|
638
695
|
| Klaim | Status implementasi | Yang hilang |
|
|
639
696
|
|---|---|---|
|
|
640
|
-
| I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`:
|
|
641
|
-
| I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) |
|
|
697
|
+
| I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: PgUp/PgDn dan Esc diintercept sebelum `tooSmall()`) | Ditutup: `test/tui-app.test.ts` membuktikan scroll posisi baca bertahan saat layar dipulihkan dan Esc memanggil abort; `Ctrl+D` tetap jalan keluar terakhir. |
|
|
698
|
+
| I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Ditutup: `test/tui-app.test.ts` meng-assert baris spacer dalam frame penuh 14 baris. |
|
|
642
699
|
| I20 — lebar kotak popup tetap per permukaan | Terimplementasi | `test/tui-app.test.ts` menandai salah satu test-nya sebagai `(I20)`, padahal test itu milik I13 (status bar). Lebar popup diverifikasi di `test/tui-geometry.test.ts` + `test/dialog.test.ts`; label di `tui-app` menyesatkan. |
|
|
643
700
|
| I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
|
|
644
701
|
| I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
|
|
645
702
|
| I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
|
|
646
|
-
| I3 —
|
|
703
|
+
| I3 — kepemilikan frame tunggal selama alternate-screen | `App` merender frame ke stdout; `simple` quiet dan transient stderr ditahan selama layar dimiliki TUI | Ditutup untuk jalur yang diuji: `test/terminal-contract.test.ts` memastikan printer linear quiet tetap tidak menulis, `test/pty.test.ts` mengamati frame produksi, dan `test/writer-inventory.test.ts` mengunci daftar writer. Suite PTY berjalan pada CI Linux; Windows ConPTY tidak menjalankan seluruh kasus PTY. |
|
|
704
|
+
| UI-COMPAT-01 — startup TUI gagal | Non-TTY/terminal tak mampu menolak fullscreen tanpa fallback linear; diagnostik stderr dan exit 1 | Ditutup: `test/tui-startup-failure.test.ts` menguji CLI produksi via subprocess; `test/pty.test.ts` menguji terminal di bawah minimum tanpa `?1049h`. Exit code PTY hanya diklaim jika platform mengembalikan angka. |
|
|
705
|
+
| UI-RENDER-02 — exception render melewati teardown | `TuiApp.run()` melakukan cleanup idempoten di `finally`; write frame melempar ke owner | Ditutup untuk initial paint, writer frame, dan event repaint: `test/tui-app.test.ts` + `test/screen.test.ts` memverifikasi alt-screen, raw mode, listener, subscription, timer dan sync-update. Sinyal POSIX diperiksa terpisah; Windows melewati test sinyal POSIX. |
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
# UI Render Pipeline — peta jalur provider stream → terminal
|
|
2
|
+
|
|
3
|
+
Dokumen ini hasil audit stabilitas UI/UX terminal 2026-09-18 (baseline v0.9.27).
|
|
4
|
+
Sumber kebenaran perilaku tetap `docs/TERMINAL_CONTRACT.md` (FROZEN); dokumen
|
|
5
|
+
ini memetakan IMPLEMENTASI aktual per tahap beserta kontrak event dan temuan
|
|
6
|
+
audit. Angka test di sini diukur di Windows + Bun 1.4.2, suite penuh hijau.
|
|
7
|
+
|
|
8
|
+
Konvensi: `file:line` menunjuk simbol yang dimaksud. Aturan repo tetap berlaku:
|
|
9
|
+
`cli/` boleh impor `src/ui/` dan `src/`; `src/` non-ui DILARANG impor
|
|
10
|
+
`src/ui/`; `src/ui/` DILARANG impor `cli/`, `src/` non-ui, `#minicore`
|
|
11
|
+
(dijaga `test/ui-boundary.test.ts`).
|
|
12
|
+
|
|
13
|
+
## 1. Jalur pipeline (9 tahap)
|
|
14
|
+
|
|
15
|
+
Tahap A — provider stream mentah: `src/providers/router.ts` (fallback +
|
|
16
|
+
`provider:text/extension/tool_call/finish`), `src/providers/guards.ts:32`
|
|
17
|
+
(timeout + text-cap + stream-guard tunggal), adapter `anthropic.ts`,
|
|
18
|
+
`responses.ts`, `effort.ts`. Dirakit di `src/app/provider-layer.ts`.
|
|
19
|
+
|
|
20
|
+
Tahap B — kernel emit ke `session.events`: `vendor/minicore/src/core/loop.ts`
|
|
21
|
+
(`turn:started`, `provider:text` per chunk, `provider:extension`
|
|
22
|
+
reasoning/usage/error, `context:compacted` reason `pressure:*`/`recovery`,
|
|
23
|
+
`step:started/completed`), `executor.ts` (`execution:started/completed`),
|
|
24
|
+
`session.ts` (`turn:completed` HANYA di jalur sukses).
|
|
25
|
+
|
|
26
|
+
Tahap C — raw runtime/content contract: `src/ui/contract.ts:33` `UiEvent` masih
|
|
27
|
+
mencerminkan bentuk event kernel untuk streaming konten dan transport. Ledger,
|
|
28
|
+
status, lifecycle, dan keputusan user-facing melalui `PresentationEvent` +
|
|
29
|
+
`PresentationPolicy` dari `cli/setup.ts`; `attachSimpleLogger` dan
|
|
30
|
+
`attachTurnStatus` tetap memasang listener runtime per turn dan melepasnya di
|
|
31
|
+
`finally` agar event telat hening.
|
|
32
|
+
|
|
33
|
+
Tahap C2 — semantic presentation bridge: `cli/setup.ts` membuat
|
|
34
|
+
`PresentationAdapter`, mengurangi event ke `PresentationState` lengkap
|
|
35
|
+
(conversation, reasoning, system, plan, finding, result, diagnostic), menghitung
|
|
36
|
+
summary dari evidence, dan memuat ulang `presentation_events` saat resume. Bridge
|
|
37
|
+
memprojection seluruh `DomainEventType` melalui `toPresentationEvent()`;
|
|
38
|
+
`src/presentation/projection.ts` menyediakan keputusan policy murni (deskripsi
|
|
39
|
+
activity/turn, running pin, envelope machine) yang di-inject ke renderer sebagai
|
|
40
|
+
`PresentationPolicy`. Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`.
|
|
41
|
+
|
|
42
|
+
Tahap D — logger utama `src/ui/assistant/simple.ts:104`: append-only
|
|
43
|
+
scrollback, tanpa alternate screen. `provider:text` → `sanitizeAnsi` PER CHUNK
|
|
44
|
+
→ `streamBuffer` → `flushBuf` (line-buffered) → `flushLine` (fence-state +
|
|
45
|
+
`decorateMarkdown` + `formatWrapped`) → `stdout`. Jawaban bisa minimize
|
|
46
|
+
(buffer 1MB + marker, dibuka via `/expand`).
|
|
47
|
+
|
|
48
|
+
Tahap E — garis status transient `src/ui/assistant/turn-status.ts`: satu baris
|
|
49
|
+
`stderr` untuk shell/linier, hidup hanya di fase sunyi (latch
|
|
50
|
+
`turnOn && !textOn`), hilang saat teks mengalir, hidup lagi saat tool
|
|
51
|
+
berikut. `endTurn()` deterministik dari driver `finally` (kernel tak emit
|
|
52
|
+
`completed` saat gagal/abort). TUI fullscreen tidak memakai painter transient
|
|
53
|
+
ini karena alternate screen dimiliki `TuiApp`.
|
|
54
|
+
|
|
55
|
+
Tahap F — arbitrator `src/ui/runtime/statusline.ts`: satu pemilik transient
|
|
56
|
+
(`turn` vs `spinner`); tulis asing saat painter aktif dikomit
|
|
57
|
+
(clear → tulis → repaint) sehingga diagnostik tak hilang; overlap = signal,
|
|
58
|
+
bukan crash. `paintWrite` tak pernah melempar (fail-closed Bun Windows).
|
|
59
|
+
|
|
60
|
+
Tahap G — status bar `src/ui/footer.ts` dirender `src/ui/tui/app.ts` sebagai
|
|
61
|
+
baris dasar frame fullscreen. `TuiApp` memiliki clock activity 200ms untuk
|
|
62
|
+
menggambar `✦`, timer `HH.MM.SS` di sebelah sparkle, dan dots reasoning
|
|
63
|
+
`...` → `..` → `.` tanpa label `Working`/`Thinking`/`Running`. Timer redup saat
|
|
64
|
+
idle dan putih saat aktif. Composer hanya menampilkan `minicode ›` setelah
|
|
65
|
+
Prompt tampil saat boot/idle, hilang saat busy, dan kembali otomatis setelah
|
|
66
|
+
turn selesai; aksi edit/histori tetap dapat membuka composer. Bullet separator
|
|
67
|
+
footer dihapus; field dipisahkan dengan spasi dan warna. Satu baris kosong memisahkan composer
|
|
68
|
+
dari footer; layout normal dan popup memakai helper geometri yang sama.
|
|
69
|
+
`TuiApp` mengaktifkan mouse tracking `?1002h + ?1006h` selama TUI; wheel
|
|
70
|
+
menggeser viewport transkrip, drag kiri membuat selection app-level, dan
|
|
71
|
+
`Ctrl+C` menyalin selection melalui DI/OSC52. Popup menurunkan ke mode
|
|
72
|
+
`?1000h`; tracking dimatikan pada quit, release, dan sinyal fatal.
|
|
73
|
+
Footer/chrome lama (`src/ui/runtime/chrome.ts`, DECSTBM scroll-region,
|
|
74
|
+
`MINICODE_FOOTER`) DIHAPUS bersama lapisan TUI lama — alternate screen
|
|
75
|
+
menggantikannya; nol byte di non-TTY. Footer baca `session.contextTokens` kernel
|
|
76
|
+
(bukan spend kumulatif).
|
|
77
|
+
|
|
78
|
+
Tahap H — primitif render `src/ui/render/`: `sanitize.ts` (hanya SGR lolos),
|
|
79
|
+
`markdown.ts` + `highlight.ts` (fence-state per baris, konten utuh),
|
|
80
|
+
`width.ts` (kolom: CJK/emoji 2, potong aman-SGR), `wrap.ts` (lebar dibaca
|
|
81
|
+
per baris → aman resize), `theme.ts` (getter warna/glyph, jangan di-`const`),
|
|
82
|
+
`errors.ts` (pesan actionable + redact), `collapse.ts` (buffer `/expand`
|
|
83
|
+
200KB/entry, 500KB total), `markdown-table.ts`/`table-grid.ts` (pipe-table
|
|
84
|
+
model), `diff.ts`/`table.ts`/`money.ts`/`format.ts`.
|
|
85
|
+
|
|
86
|
+
Tahap H2 — tabel Markdown model: `src/ui/render/markdown-table.ts` memvalidasi
|
|
87
|
+
header/delimiter, escaped pipe, code span, alignment, dan fence; stream block
|
|
88
|
+
di-buffer sampai batas tabel. `table-grid.ts` menghitung lebar kolom dan budget
|
|
89
|
+
terminal, sedangkan linear/TUI me-render semantic block yang sama pada TTY dan
|
|
90
|
+
mempertahankan source sanitized pada non-TTY. `exec --json`/ACP tidak melewati
|
|
91
|
+
renderer ini.
|
|
92
|
+
Tahap I — view murni vs controller: `src/ui/screens/` (props + callback,
|
|
93
|
+
tanpa IO) digerakkan `cli/` (`tui.ts`, `commands.ts`, `wizard.ts`,
|
|
94
|
+
`provider/model-manager.ts`, `approval/prompt.ts` via DI `ask`,
|
|
95
|
+
`setupWhenEmpty`, `setSubAgentSessionFactory`).
|
|
96
|
+
|
|
97
|
+
## 2. Kontrak Event → UI
|
|
98
|
+
|
|
99
|
+
Kolom: S = bisa di-stream, D = bisa duplikat, O = bisa out-of-order,
|
|
100
|
+
I = bisa diinterupsi, L = bisa tiba setelah completion.
|
|
101
|
+
|
|
102
|
+
| Event | Producer | Representasi UI | S | D | O | I | L |
|
|
103
|
+
|---|---|---|---|---|---|---|---|
|
|
104
|
+
| assistant text | provider stream | stdout wrap + fence 2-spasi; pipe-table-aligned di TTY, source sanitized di non-TTY | ya | tidak (E1) | tidak | ya (abort) | tidak (detach flush 1x, E6) |
|
|
105
|
+
| tool call | model → kernel | `› nama target` muted (compact: diam) | tidak | tidak | tidak | ya | tidak |
|
|
106
|
+
| tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer | tidak | tidak | tidak | ya | tidak |
|
|
107
|
+
| reasoning | provider extension | TUI composer: dots clock tanpa marker transcript; expanded transcript/linear tetap live per baris; minimized tetap buffer untuk `/expand` | ya | tidak | tidak | ya | tidak |
|
|
108
|
+
| thinking effort | picker `/model` | badge + level per model | tidak | tidak | tidak | tidak | tidak |
|
|
109
|
+
| usage | provider extension | verbose saja; masuk budget watcher | ya | tidak | ya (tail pasca-finish) | ya | ya (diabaikan aman) |
|
|
110
|
+
| compaction | kernel loop | `── compacted: <reason>` kuning, reason verbatim | tidak | tidak | tidak | tidak | tidak |
|
|
111
|
+
| permission request | executor → `ask` DI | header stdout + `askLine y/a/n`, fail-closed non-TTY | tidak | tidak | tidak | ya (deny) | tidak |
|
|
112
|
+
| permission denied | executor | error tool penuh, tak pernah minimize + reason | tidak | tidak | tidak | tidak | tidak |
|
|
113
|
+
| sub-agent | delegate_task → bus parent | ledger `›` biasa + usage; tanpa view khusus | tidak | tidak (jurnal skip forward) | tidak | ya | tidak |
|
|
114
|
+
| error provider | provider extension | `pendingError` consume-once → satu `✗` oleh driver | tidak | tidak (E15) | tidak | ya | tidak |
|
|
115
|
+
| warning | budget/recovery/verify | `[budget]`/`[recovery]`/`[verify]` kuning stderr | tidak | tidak (warned80 sekali) | tidak | tidak | tidak |
|
|
116
|
+
| completion | kernel loop | flush + `finalizeAnswer` + footer idle | tidak | tidak | tidak | tidak | tidak |
|
|
117
|
+
| abort | user/Esc | `(stopped)` + cleanup `finally` | tidak | tidak | tidak | — | tidak |
|
|
118
|
+
| timeout | kernel `createTimeout` | `✗ timeout` + turn dibuang transaksional | tidak | tidak | tidak | — | ya (late work ke turnStore privat, dibuang) |
|
|
119
|
+
| budget exceeded | watcher/driver | `[budget] … stopping turn` + abort ber-kind | tidak | tidak (fire-once) | tidak | — | tidak |
|
|
120
|
+
| provider failure | recovery policy | retry/compact/throw deterministik; cap retryAfter 30 dtk | tidak | tidak | tidak | tidak | tidak |
|
|
121
|
+
|
|
122
|
+
Mismatch yang dicari, hasil: raw EventBus tetap ada untuk konten/streaming,
|
|
123
|
+
tetapi keputusan user-facing kini membaca policy yang sama (raw ledger TUI
|
|
124
|
+
dihapus di Phase 8). Buffer jawaban live TUI dibatasi 1.000.000 karakter;
|
|
125
|
+
layout paint memakai satu proyeksi transcript dan cache render jawaban.
|
|
126
|
+
`cli/setup.ts:172-376` memproyeksikan seluruh `DomainEventType` secara
|
|
127
|
+
exhaustive; TUI memakai `describeActivity`/`matchTurn`/`elapsedVisible` via
|
|
128
|
+
injeksi, linear memakai deskripsi + `activityFor` untuk label turn-status, dan
|
|
129
|
+
machine memakai `toMachineEnvelope`. `bus-debug.ts` hanya debug subscription.
|
|
130
|
+
Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`,
|
|
131
|
+
`docs/OUTPUT_PROTOCOL_SPEC.md`, dan `docs/OUTPUT_RENDERING_SPEC.md`. State
|
|
132
|
+
turunan yang disengaja tetap footer memakai `contextTokens` (estimasi jendela), sedangkan `/status`
|
|
133
|
+
memisahkan Context/Input/Output/Total/Cost/Budget di
|
|
134
|
+
`docs/CONTROL-PLANE-MAP.md`.
|
|
135
|
+
|
|
136
|
+
## 3. State machine TUI (tidak eksplisit)
|
|
137
|
+
|
|
138
|
+
Tidak ada `enum` state; fase disimpulkan: `abort !== null` (busy),
|
|
139
|
+
`turnOn/textOn` (painter), `regionOn/detached` (chrome), plus ~14 flag
|
|
140
|
+
(`mode`, `escTimer`, `pending`, `nullStreak`, `warned80`, `activeSection`,
|
|
141
|
+
minimize toggles, buffer, `pendingError`, raw-mode listener). Invarian dijaga
|
|
142
|
+
`finally`/`detachUI`/`endTurn`, bukan type-state. Transisi ilegal yang
|
|
143
|
+
terbukti dicegah: painter saat teks mengalir, `endTurn` ganda, error ganda,
|
|
144
|
+
`+`/`-` di pipe, decoder bocor antar prompt, Tab membajak search.
|
|
145
|
+
Satu lubang nyata: listener approval `askLine` menempel DI ATAS `onBusyKey`
|
|
146
|
+
selama busy (byte Ctrl+C diterima keduanya) — aman fail-closed
|
|
147
|
+
(`raceAbort` → deny) tetapi observabilitas ganda. Lihat §5 temuan O1.
|
|
148
|
+
|
|
149
|
+
## 4. Temuan audit 2026-09-18 (eksperimen di /tmp, repo tak diubah)
|
|
150
|
+
|
|
151
|
+
F1 HIGH — SGR terbelah antar-chunk merusak output model. `sanitizeAnsi`
|
|
152
|
+
diterapkan PER CHUNK (`simple.ts:287`): `["\x1b[", "32mHello"]` tampil
|
|
153
|
+
literal `32mHello`. Bukti: harness E3 `out="32mHellom\n"`. Kelas sama untuk
|
|
154
|
+
OSC tak-terminasi (menelan sisa chunk). Perbaikan terkecil: tahan ekor
|
|
155
|
+
escape tak-lengkap di buffer dan sambung ke chunk berikut sebelum sanitasi.
|
|
156
|
+
|
|
157
|
+
F2 MEDIUM — SGR model bocor mentah ke stdout non-TTY. `"\x1b[31mRed\x1b[0m"`
|
|
158
|
+
satu chunk lolos `sanitizeAnsi` (by-design) lalu ditulis ke pipe apa adanya
|
|
159
|
+
(`out="\u001b[31mRed\u001b[0m\n"`), melanggar kontrak non-TTY deterministik.
|
|
160
|
+
Perbaikan terkecil: strip SGR (atau render via `c.*`) saat `!isTTY`.
|
|
161
|
+
|
|
162
|
+
F3 LOW — buffer thinking `/expand` membuang kepala diam-diam
|
|
163
|
+
(`thinkingBuf.slice(-200_000)` tanpa marker seperti `, capped 1MB` pada
|
|
164
|
+
answer). Informasi diagnostik hilang tanpa jejak.
|
|
165
|
+
|
|
166
|
+
O1 LOW — listener ganda approval vs busy-key (§3). Fail-closed, catat saja.
|
|
167
|
+
|
|
168
|
+
Status hardening (sesudah audit): F1 diperbaiki via `createStreamSanitizer`
|
|
169
|
+
+ `splitTrailingEscape` di `src/ui/render/sanitize.ts` (dipakai jalur teks
|
|
170
|
+
model/reasoning/bash di `simple.ts`, flush deterministik saat
|
|
171
|
+
completed/detach); F2 via kebijakan `stripSgr` non-TTY di `wOut`/`wErr` +
|
|
172
|
+
`rememberTurn` (cerminan `colorLevel` → `stdout.isTTY`); F3 via marker
|
|
173
|
+
`… (earlier thinking truncated)`; O1 didokumentasikan di `src/ui/tui/app.ts`
|
|
174
|
+
(busy-freeze + abort, tanpa refactor). Snap kiri/kanan: render pertama sesudah
|
|
175
|
+
geometri berubah
|
|
176
|
+
me-reset jangkar relatif askLine (`lastGeoCols/Rows` di `input.ts`) —
|
|
177
|
+
geometri lebar tak dilacak footer karena erase baris-absolut tak sound
|
|
178
|
+
pasca-reflow (terbukti model + ConPTY: reflow milik konsumen).
|
|
179
|
+
Dijaga `test/ansi-fragmentation.test.ts`
|
|
180
|
+
(termasuk properti semua-titik-belah ≡ whole-string),
|
|
181
|
+
`test/non-tty-output.test.ts`, `test/thinking-truncation.test.ts`,
|
|
182
|
+
`test/ui-combined.test.ts` (satu sistem: stream + tool + resize + footer),
|
|
183
|
+
`test/input-resize.test.ts` (gagal di kode lama: CUP ke anchor basi).
|
|
184
|
+
|
|
185
|
+
Batas yang TERVERIFIKASI BENAR (bukti harness + 178 test UI hijau):
|
|
186
|
+
token-by-token tepat-1x (E1), chunk 50KB utuh (E2), fence terbelah benar
|
|
187
|
+
termasuk yatim saat abort (E4/E4b), abort flush tepat-1x tanpa bocor ke turn
|
|
188
|
+
berikut (E6), urutan teks>tool>hasil (E7), permission fail-closed (E8),
|
|
189
|
+
kontrak budget murni vs gate (E9), tiga reason kompaksi tampil beda (E10),
|
|
190
|
+
forward sub-agent sebagai ledger biasa (E11), tool 5000-baris dipotong +
|
|
191
|
+
ANSI jahat dibuang (E12), decoder UTF-8 per-byte + ESC-split + paste 100KB
|
|
192
|
+
(E13), soak 50 turn tepat-1x 38ms +4.6MB tanpa ESC mentah (E14),
|
|
193
|
+
error consume-once + format actionable (E15), resize 120→20 mid-stream aman
|
|
194
|
+
(E5b), 10k events 151k ev/s tepat-1x (E17), CJK/emoji/wrap/truncate/fence
|
|
195
|
+
(E5), emphasis tak-seimbang lewat literal + tabel konten-tetap (fidelitas).
|
|
196
|
+
|
|
197
|
+
## 5. Residual risk (jujur, belum dibuktikan di audit ini)
|
|
198
|
+
|
|
199
|
+
Jalur TTY-live (painter denyut, footer sticky DECSTBM, overlay picker,
|
|
200
|
+
tombol busy) hanya tercakup harness fake-TTY + 178 test; tidak ada sesi TTY
|
|
201
|
+
nyata di audit ini. Chaos kombinasi (stream+resize+abort serentak di TTY)
|
|
202
|
+
dan soak 100+ turn multitool belum dijalankan. Sub-agent tanpa view khusus:
|
|
203
|
+
indukan dibedakan hanya dari nama tool (cukup untuk 1 level, belum diuji
|
|
204
|
+
visual untuk delegasi bertingkat — yang memang dilarang: tanpa nesting).
|
package/docs/agents.md
CHANGED
|
@@ -5,20 +5,20 @@
|
|
|
5
5
|
|
|
6
6
|
Sub-agent = instans agent dengan **context terpisah** dari parent: memory, signal, dan budget sendiri. Pool concurrency 3 — maksimum 3 sub-agent hidup sekaligus — dan abort-aware (mewarisi AbortSignal parent; parent batal → anak berhenti).
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
`delegate_task` meminta persetujuan di **ASK** (TTY); non-TTY menolak. Di **AUTO**, delegasi berjalan tanpa prompt jika capability telah diotorisasi. Anak mewarisi WorkMode parent; `DISCUSS`/`PLAN` membatasi tool anak ke subset eksplorasi baca-saja. **Satu approval di ASK hanya mencakup satu delegasi.**
|
|
9
9
|
|
|
10
10
|
## Mode anak: `explore` / `plan`
|
|
11
11
|
|
|
12
12
|
| Mode anak | Kemampuan |
|
|
13
13
|
|---|---|
|
|
14
|
-
| `explore` | Subset
|
|
15
|
-
| `plan` |
|
|
14
|
+
| `explore` | Subset tool eksplorasi baca-saja untuk mencari dan memahami kode |
|
|
15
|
+
| `plan` | Tidak mendapat `todo_write`, mutasi memory, commit, nesting, atau job background. Parent PermissionMode `ASK`, `plan`, atau `readonly` memaksa mode anak menjadi `explore`. WorkMode parent `DISCUSS`/`PLAN` juga membatasi daftar tool anak ke subset eksplorasi; pada `BUILD`, mode `plan` dapat memakai tool dasar yang tersedia, tetap tunduk pada PermissionMode anak |
|
|
16
16
|
|
|
17
|
-
Restriksi anak yang **selalu** berlaku:
|
|
17
|
+
Restriksi anak yang **selalu** berlaku: `delegate_task`, `git_commit`, memory/todo writes, `submit_result`, `bash_output`, dan `bash_kill` tidak tersedia. Background shell ditolak agar tidak membuat job yatim. Daftar tool dinamis MCP tidak diteruskan ke anak. WorkMode `BUILD` adalah label produk untuk identitas runtime `EXECUTE`.
|
|
18
18
|
|
|
19
19
|
## Kenapa dibatasi
|
|
20
20
|
|
|
21
|
-
Sub-agent menjalankan task tanpa Anda di depan layar.
|
|
21
|
+
Sub-agent menjalankan task tanpa Anda di depan layar. Karena itu kemampuan commit dan capability MCP tidak diteruskan; mode `explore` dan WorkMode ketat hanya memberi tool eksplorasi. Mode `plan` di bawah `BUILD` tetap dapat mengubah file atau menjalankan tool dasar, sehingga hasilnya harus ditinjau parent.
|
|
22
22
|
|
|
23
23
|
## Recovery
|
|
24
24
|
|