minicode-ai 0.14.2 → 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/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 +30 -15
- package/cli/provider-manager.ts +1 -3
- package/cli/setup.ts +167 -143
- package/cli/tui.ts +15 -23
- package/docs/CONTROL-PLANE-MAP.md +145 -0
- package/docs/OUTPUT_EVENT_MODEL.md +1 -1
- package/docs/OUTPUT_PROTOCOL_SPEC.md +2 -2
- package/docs/OUTPUT_RENDERING_SPEC.md +7 -2
- 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 +84 -51
- 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/glossary.md +8 -6
- package/docs/memory-sessions.md +7 -5
- package/docs/policy-sandbox.md +16 -14
- package/docs/quickstart.md +2 -2
- package/docs/repl.md +4 -3
- package/docs/security-model.md +14 -15
- package/docs/security.md +8 -29
- package/docs/skills.md +1 -1
- package/docs/tools.md +2 -2
- package/package.json +5 -3
- package/scripts/vendor-overlays/minicode-context.patch +109 -0
- package/src/app/provider-layer.ts +13 -1
- package/src/app/session.ts +216 -13
- package/src/config.ts +30 -3
- package/src/constants.ts +2 -0
- package/src/daemon/control.ts +1 -1
- package/src/mcp/server.ts +2 -3
- package/src/policy/compaction.ts +272 -16
- package/src/policy/context-window.ts +73 -0
- package/src/policy/context.ts +55 -3
- package/src/policy/ratelimit.ts +47 -18
- package/src/policy/usage.ts +15 -8
- package/src/policy/work-mode.ts +1 -1
- package/src/providers/guards.ts +61 -4
- package/src/providers/provision.ts +12 -3
- package/src/providers/router.ts +56 -23
- package/src/session/context-projection.ts +14 -0
- package/src/session/context-selector.ts +58 -20
- package/src/session/persistence.ts +1 -1
- package/src/task/model.ts +21 -70
- package/src/tools/task.ts +7 -0
- package/src/ui/footer.ts +131 -66
- package/src/ui/i18n/en.ts +0 -11
- package/src/ui/i18n/id.ts +0 -11
- package/src/ui/input/input.ts +2 -3
- package/src/ui/input/prompt-engine.ts +2 -5
- 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 +10 -6
- package/src/ui/tui/transcript.ts +48 -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/docs/OUTPUT_ARCHITECTURE_AUDIT.md +0 -489
- package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +0 -391
|
@@ -1,17 +1,38 @@
|
|
|
1
|
-
# Kontrak Terminal MiniCode (TUI fullscreen — v7.
|
|
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.
|
|
2
24
|
|
|
3
25
|
Perubahan v7.5: kepemilikan frame stdout interaktif diperjelas; cleanup `TuiApp.run()`
|
|
4
26
|
berpasangan melalui `finally`; gap proteksi teardown, startup, spacer, layar kecil,
|
|
5
27
|
dan writer ownership ditutup dengan test app/subprocess/PTY.
|
|
6
28
|
|
|
7
|
-
Perubahan v7.4 (P12 S2.2 WorkMode): invarian
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
`
|
|
13
|
-
|
|
14
|
-
permission mode. Rincian di I35.
|
|
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.
|
|
15
36
|
|
|
16
37
|
Perubahan v7.3 (P11 Presentation & UX): invarian baru I34 — subcommand `exec`
|
|
17
38
|
dan `daemon` menerima argv SCOPE dari router (flag global dikenal yang
|
|
@@ -94,7 +115,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
94
115
|
- **Sinyal fatal** (I31): saat sesi TUI hidup, `App.run()` memasang
|
|
95
116
|
`process.on("SIGTERM")`/`process.on("SIGHUP")` (handler terpisah karena Bun
|
|
96
117
|
tak menyampaikan nama sinyal — satu handler bersama tak bisa membedakan)
|
|
97
|
-
→ 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
|
|
98
120
|
`process.exit(128+n)`. Pasangan ketat: keduanya dilepas di cleanup `run()` —
|
|
99
121
|
tanpa sesi TUI, sinyal TIDAK di-intercept (perilaku default proses tetap).
|
|
100
122
|
Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
|
|
@@ -135,7 +157,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
135
157
|
atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
|
|
136
158
|
`dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
|
|
137
159
|
sendiri.
|
|
138
|
-
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider
|
|
160
|
+
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 52,
|
|
139
161
|
form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
|
|
140
162
|
Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
|
|
141
163
|
hilang, id selamat).
|
|
@@ -194,8 +216,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
194
216
|
live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
|
|
195
217
|
layout paint tidak boleh memproyeksikan transcript dua kali.
|
|
196
218
|
|
|
197
|
-
13. Status bar: 1 baris dasar (`✦ 00.00.00
|
|
198
|
-
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;
|
|
199
225
|
timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
|
|
200
226
|
detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
|
|
201
227
|
Reasoning memakai dots `...` → `..` → `.` → `..` →
|
|
@@ -210,7 +236,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
210
236
|
**Shift+PgUp/PgDn (ESC[5;2~/6;2, modifier 2) = setengah halaman; Home/End
|
|
211
237
|
saat prompt KOSONG = lompat baris-teratas/ekor transkrip (baris berisi =
|
|
212
238
|
editing awal/akhir baris; dropdown terbuka = jalur engine)**; Up/Down
|
|
213
|
-
histori; Tab/Shift+Tab
|
|
239
|
+
histori; Tab WorkMode / Shift+Tab PermissionMode; Ctrl+O/T compact/thinking; Ctrl+D baris-kosong
|
|
214
240
|
keluar; Esc membersihkan selection lebih dulu, lalu batal input / abort
|
|
215
241
|
turn (busy: SEMUA input dibekukan kecuali abort, scroll, dan selection —
|
|
216
242
|
Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll selalu lolos
|
|
@@ -255,7 +281,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
255
281
|
berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
|
|
256
282
|
oldest-to-newest) melalui OSC 52.
|
|
257
283
|
19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
|
|
258
|
-
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,
|
|
259
285
|
form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
|
|
260
286
|
selalu tampil.
|
|
261
287
|
21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
|
|
@@ -344,20 +370,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
344
370
|
invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
|
|
345
371
|
35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
|
|
346
372
|
dimensi yang BERJALAN BERSAMA, bukan pengganti:
|
|
347
|
-
**Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
|
|
373
|
+
**Nilai runtime:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
|
|
348
374
|
lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
|
|
349
375
|
(ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
|
|
350
|
-
|
|
351
|
-
ceiling tambahan).
|
|
352
|
-
|
|
353
|
-
**Gerbang penolakan & side-effect ceiling:**
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
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,
|
|
357
383
|
hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
|
|
358
384
|
ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
|
|
359
385
|
serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
|
|
360
|
-
**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.
|
|
361
388
|
Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
|
|
362
389
|
kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
|
|
363
390
|
(handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
|
|
@@ -370,42 +397,47 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
370
397
|
**Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
|
|
371
398
|
(`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
|
|
372
399
|
(`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
|
|
373
|
-
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
|
|
374
402
|
composition root menulis SATU baris stderr human-facing
|
|
375
403
|
(`[resume] WorkMode <MODE> restored from session...` atau notice override/
|
|
376
404
|
legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
|
|
377
405
|
keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
|
|
378
406
|
terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
|
|
379
407
|
**Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
|
|
380
|
-
footer (
|
|
381
|
-
baris stderr human-facing `[work-mode] <MODE>
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
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
|
|
385
413
|
dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
|
|
386
414
|
vs `/mode`/`--plan`) dan dari status sesi.
|
|
387
|
-
**Pemisahan dari
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
(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.
|
|
391
420
|
**Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
|
|
392
|
-
**per pemanggilan** dengan WorkMode **AKTIF
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
`
|
|
400
|
-
|
|
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.
|
|
401
432
|
|
|
402
433
|
## Grammar (ringkas)
|
|
403
434
|
|
|
404
435
|
prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
|
|
405
436
|
berbingkai di atasnya) ·
|
|
406
|
-
status bar `✦ 00.00.00
|
|
407
|
-
menit mulai terang di 60 dtk, jam di 1
|
|
408
|
-
|
|
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)
|
|
409
441
|
+ satu spacer sebelum footer · ledger tool
|
|
410
442
|
` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
|
|
411
443
|
kegagalan · pesan error TUI = formatter kanonik (`formatError`,
|
|
@@ -520,14 +552,14 @@ panjang).
|
|
|
520
552
|
Esc-1 kembalikan prefill, Esc-2 batal).
|
|
521
553
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
522
554
|
stdout-pipe tanpa sink = deny).
|
|
523
|
-
- `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).
|
|
524
556
|
- `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
|
|
525
|
-
dievaluasi per pemanggilan tool; transisi EXECUTE↔DISCUSS↔PLAN pada sesi
|
|
557
|
+
dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
|
|
526
558
|
yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
|
|
527
559
|
WorkMode aktif; delegasi mewarisi WorkMode parent terbaru; argumen
|
|
528
560
|
delegasi tak bisa menaikkan WorkMode; `/work-mode` end-to-end lewat TUI
|
|
529
|
-
termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode;
|
|
530
|
-
|
|
561
|
+
termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; footer
|
|
562
|
+
memakai label title case; Tab mengubah WorkMode dan Shift+Tab tidak).
|
|
531
563
|
- `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
|
|
532
564
|
handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
|
|
533
565
|
`web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
|
|
@@ -542,7 +574,8 @@ panjang).
|
|
|
542
574
|
- `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
|
|
543
575
|
tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
|
|
544
576
|
- `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
|
|
545
|
-
resume > default
|
|
577
|
+
resume > default DISCUSS; nilai invalid → DISCUSS + peringatan; input operator
|
|
578
|
+
hanya DISCUSS/PLAN/BUILD; `--verify`
|
|
546
579
|
ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
|
|
547
580
|
`workMode` parity).
|
|
548
581
|
- `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I14/I17 (composer
|
|
@@ -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
|
|
package/docs/architecture.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Arsitektur
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Dokumen ini adalah peta struktur dan alur runtime yang aktif untuk kontributor.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Roadmap fase pemilik tidak tersedia di checkout ini; jangan simpulkan status fase atau next action dari changelog maupun kode. `TERMINAL_CONTRACT.md` adalah kontrak terminal FROZEN — baca sebelum mengubah output; perubahan perilaku memerlukan pembaruan kontrak dan peta test. Kontrak output aktif ada di [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), dan [UX rules](OUTPUT_UX_RULES.md). Peta alur rendering ada di [UI Render Pipeline](UI_RENDER_PIPELINE.md).
|
|
6
6
|
|
|
7
7
|
## Tiga lapisan
|
|
8
8
|
|
|
@@ -12,6 +12,13 @@ L2 src/ non-ui → agen: tools, agents, hooks, policy, providers, mcp, lsp,
|
|
|
12
12
|
L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (freeze, zero-dep, via #minicore)
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
+
Pin source kernel ada di [catatan vendor MiniCore](https://github.com/startupmini/minicode/blob/main/vendor/minicore/VENDOR.md):
|
|
16
|
+
`0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
|
|
17
|
+
|
|
18
|
+
Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
|
|
19
|
+
diterapkan saat sinkronisasi vendor; `VENDOR.md` mem-pin source, overlay, dan
|
|
20
|
+
fingerprint hasil akhirnya.
|
|
21
|
+
|
|
15
22
|
- `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
|
|
16
23
|
- Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
|
|
17
24
|
- DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `createProviderLayer → loadLastModel → createRagLayer → resume presentation-events + planRecovery + reconcileUndoRedo → setupToolLayer + setAskTextFn → createMinicodeSession → journal + checkpoint + semantic event sink + step-trace + runPromptWithVerify (baseline-first + self-heal 3 siklus + hooks) → logger + turn-status + usage/pricing → persist/finalize → close (kill jobs, mcp/lsp close)`. `setSubAgentSessionFactory` sebelum dispatch agar TUI/one-shot/`mcp serve` tercakup.
|
|
@@ -29,13 +36,16 @@ dutinya:
|
|
|
29
36
|
| Lapis | Isi | Authoritatif untuk |
|
|
30
37
|
|---|---|---|
|
|
31
38
|
| Kernel `ContextStore` | history yang dikirim ke model, bisa lossy saat kompaksi | window berjalan |
|
|
32
|
-
| Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error
|
|
33
|
-
| Vektor memory + `presentation_events` | ringkasan
|
|
39
|
+
| Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error`; dapat diganti saat shrink kompaksi | continuity/resume dari bentuk tersimpan saat ini |
|
|
40
|
+
| Vektor memory + `presentation_events` | ringkasan memory best-effort dan event semantik terpilih | RAG & audit UI; bukan salinan lengkap percakapan |
|
|
34
41
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
42
|
+
Kompaksi bersifat lossy, termasuk setelah restart. `persistCurrent` mengirim
|
|
43
|
+
history yang sudah dipadatkan ke `shrinkThreadHistory`, yang menghapus lalu
|
|
44
|
+
menulis ulang baris `messages`; model mekanis juga meringkas pesan lama dan
|
|
45
|
+
menghilangkan hasil tool yang sukses. Ringkasan ke vector memory hanya dibuat
|
|
46
|
+
di jalur LLM, dibatasi, opt-out, dan best-effort. Karena itu jangan menganggap
|
|
47
|
+
semua fakta lama tetap dapat dipulihkan dari sesi atau vector store; state
|
|
48
|
+
penting harus dicatat di task, file, atau artefak verifikasi yang otoritatif.
|
|
39
49
|
|
|
40
50
|
Fidelity resume: `reasoning` (thinking) dan `is_error` (tool gagal) adalah
|
|
41
51
|
field kernel `Message` yang ikut dibawa ke history. Semula keduanya tidak punya
|
|
@@ -82,8 +92,7 @@ Tiga aturan yang menjaga domain ini:
|
|
|
82
92
|
bisa berbeda arah — dan plan event terbit di `execution:completed`, bukan
|
|
83
93
|
dari argumen sebelum tool jalan.
|
|
84
94
|
|
|
85
|
-
Batas subsystem **todo
|
|
86
|
-
audit historisnya): file todo tetap datar — tanpa field dependency di
|
|
95
|
+
Batas subsystem **todo**: file todo tetap datar — tanpa field dependency di
|
|
87
96
|
`TodoItem`, tanpa surface user (`/tasks`), `/undo` hanya revert file (todo
|
|
88
97
|
tetap `completed`), dan tanpa TTL/GC untuk file todo di luar SQLite.
|
|
89
98
|
Dependency/graph dan scheduler **sudah ada**, tetapi pada subsystem terpisah:
|
|
@@ -112,15 +121,17 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
|
|
|
112
121
|
|
|
113
122
|
Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
|
|
114
123
|
|
|
115
|
-
Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris `✦ 00.00.00
|
|
124
|
+
Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `✗ pesan actionable` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
|
|
116
125
|
|
|
117
126
|
## Modul kunci
|
|
118
127
|
|
|
119
128
|
- `src/session/verification.ts` + `src/tools/evidence.ts`: identitas invokasi milik aplikasi, intent/receipt yang di-await, observasi eksplisit, idempotency, dan korelasi efek anak — semuanya di jurnal mutasi yang sama.
|
|
120
129
|
|
|
121
130
|
- `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
|
|
122
|
-
- `src/presentation/`: `events.ts`
|
|
131
|
+
- `src/presentation/`: `events.ts` mendefinisikan event presentasi dan registry durability; `adapter.ts` memetakan runtime ke `DomainEvent`; `reducer.ts`/`model.ts` membangun state replayable dan ringkasan turunan; `store.ts` menyimpan referensi konten; `projection.ts` membentuk envelope `minicode.output.v1` dan kategori error machine. `src/session/persistence.ts` menyimpan log `presentation_events` dan `messages` dengan fidelity `reasoning`/`is_error`. `cli/setup.ts` memiliki bridge exhaustive `toPresentationEvent()`; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy`.
|
|
123
132
|
- `src/ui/input/`: `askLine`, `prompt-engine` (grapheme `Intl.Segmenter`, streaming decoder, bracket-paste, mouse X10/SGR press/drag/release + wheel dinormalisasi; selection app-level di TUI).
|
|
124
133
|
- `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
|
|
125
134
|
- `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
|
|
135
|
+
- `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
|
|
136
|
+
- `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
|
|
126
137
|
- Kualitas: `bench/`, `scripts/` (coverage/pack/telemetry/vendor), `experiments/` (adversarial).
|
package/docs/choosing-mode.md
CHANGED
|
@@ -12,16 +12,16 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
12
12
|
|
|
13
13
|
| Saya ingin… | Gunakan | Karena |
|
|
14
14
|
|---|---|---|
|
|
15
|
-
| Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal
|
|
16
|
-
| Minta agen membuat perubahan |
|
|
17
|
-
| Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
|
|
15
|
+
| Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal; network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
|
|
16
|
+
| Minta agen membuat perubahan | `--work-mode BUILD` + `AUTO` (Permission Mode default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
|
|
17
|
+
| Menyetujui setiap perubahan | `--work-mode BUILD --ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
|
|
18
18
|
| Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
|
|
19
|
-
| Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
|
|
20
|
-
| Otonom penuh di mesin sendiri | `
|
|
19
|
+
| Otomasi/CI tanpa manusia | One-shot/`exec` + default `DISCUSS` untuk baca; tambah `--work-mode BUILD` bila perlu mutasi | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
|
|
20
|
+
| Otonom penuh di mesin sendiri | `--work-mode BUILD` + `AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
|
|
21
21
|
|
|
22
22
|
## Rule of thumb
|
|
23
23
|
|
|
24
|
-
1. **
|
|
24
|
+
1. **Sesi baru mulai `DISCUSS`+`AUTO`** untuk membatasi aksi awal; pilih `BUILD` secara eksplisit saat ingin implementasi. `AUTO` mengatur persetujuan dan tidak memberi capability dengan sendirinya.
|
|
25
25
|
2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
|
|
26
26
|
3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
|
|
27
27
|
4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
|
|
@@ -38,4 +38,4 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
38
38
|
- [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
|
|
39
39
|
- [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
|
|
40
40
|
- [Otomasi & CI](exec.md) — batasan headless.
|
|
41
|
-
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|
|
41
|
+
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|