minicode-ai 0.14.6 → 0.20.0
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 +6 -4
- package/cli/args.ts +20 -8
- package/cli/commands/exec.ts +17 -14
- package/cli/commands/openwork.ts +1 -1
- package/cli/commands.ts +39 -23
- package/cli/index.ts +29 -7
- package/cli/model-manager.ts +1 -1
- package/cli/router.ts +22 -9
- package/cli/setup.ts +77 -35
- package/cli/tui.ts +179 -25
- package/docs/CONTROL-PLANE-MAP.md +7 -5
- package/docs/OUTPUT_EVENT_MODEL.md +4 -3
- package/docs/OUTPUT_PROTOCOL_SPEC.md +1 -1
- package/docs/OUTPUT_RENDERING_SPEC.md +16 -4
- package/docs/OUTPUT_UX_RULES.md +38 -32
- package/docs/P14_OPEN_WORK.md +290 -0
- package/docs/README.md +1 -1
- package/docs/SUMMARY.md +36 -22
- package/docs/TERMINAL_CONTRACT.md +89 -17
- package/docs/UI_RENDER_PIPELINE.md +47 -8
- package/docs/agents.md +1 -1
- package/docs/architecture.md +10 -8
- package/docs/autonomous-scheduler.md +142 -0
- package/docs/choosing-mode.md +4 -2
- package/docs/cli.md +11 -9
- package/docs/concepts.md +5 -5
- package/docs/config-providers.md +3 -3
- package/docs/config.md +1 -1
- package/docs/contributing.md +7 -9
- package/docs/environment.md +8 -5
- package/docs/getting-started.md +5 -5
- package/docs/mcp-lsp.md +2 -2
- package/docs/memory-sessions.md +3 -3
- package/docs/policy-sandbox.md +7 -4
- package/docs/pricing-budget.md +3 -3
- package/docs/quickstart.md +1 -1
- package/docs/repl.md +11 -8
- package/docs/security-model.md +4 -2
- package/docs/security.md +9 -8
- package/docs/skills.md +2 -2
- package/docs/terminal.md +10 -2
- package/docs/tools.md +4 -4
- package/docs/troubleshooting.md +3 -3
- package/docs/verify-benchmark.md +0 -3
- package/package.json +9 -18
- package/scripts/vendor-overlays/minicode-context.patch +1 -1
- package/src/app/mentions.ts +1 -1
- package/src/app/rag-layer.ts +11 -2
- package/src/app/session.ts +128 -10
- package/src/constants.ts +32 -1
- package/src/daemon/client.ts +11 -6
- package/src/daemon/control.ts +2 -9
- package/src/daemon/resource.ts +5 -4
- package/src/hooks/run.ts +5 -6
- package/src/lib/keystore.ts +11 -9
- package/src/lib/net.ts +8 -3
- package/src/lib/safe-open.ts +29 -5
- package/src/lib/trusted-exec.ts +4 -1
- package/src/lsp/client.ts +9 -10
- package/src/mcp/http-transport.ts +1 -1
- package/src/mcp/server.ts +17 -7
- package/src/memory/files.ts +2 -1
- package/src/memory/vector.ts +25 -16
- package/src/policy/bash-guard.ts +58 -16
- package/src/policy/bpe.ts +110 -0
- package/src/policy/compaction.ts +139 -22
- package/src/policy/consequence-engine.ts +3 -3
- package/src/policy/context-window.ts +43 -1
- package/src/policy/context.ts +50 -12
- package/src/policy/jail.ts +48 -3
- package/src/policy/no-progress.ts +15 -8
- package/src/policy/permission.ts +243 -5
- package/src/policy/tokenizer-registry.ts +104 -0
- package/src/policy/usage.ts +20 -13
- package/src/policy/verifier.ts +7 -4
- package/src/policy/work-mode.ts +9 -5
- package/src/presentation/adapter.ts +8 -4
- package/src/presentation/events.ts +2 -2
- package/src/presentation/label.ts +3 -3
- package/src/presentation/model.ts +4 -0
- package/src/presentation/projection.ts +10 -2
- package/src/presentation/store.ts +2 -2
- package/src/providers/anthropic.ts +13 -3
- package/src/providers/responses.ts +16 -6
- package/src/runtime/capability.ts +22 -4
- package/src/runtime/child-execution.ts +1 -1
- package/src/runtime/composition.ts +5 -5
- package/src/runtime/execution-journal.ts +13 -7
- package/src/runtime/execution-registry.ts +1 -1
- package/src/runtime/production-execution.ts +7 -6
- package/src/runtime/production-runtime.ts +2 -2
- package/src/runtime/runtime-capabilities.ts +1 -1
- package/src/runtime/runtime-status-facts.ts +1 -1
- package/src/runtime/runtime-task-admission.ts +2 -2
- package/src/sandbox/os.ts +4 -3
- package/src/session/checkpoint.ts +29 -4
- package/src/session/context-assembly.ts +8 -1
- package/src/session/context-identity.ts +2 -2
- package/src/session/context-projection.ts +36 -11
- package/src/session/persistence.ts +22 -11
- package/src/task/autonomous-context.ts +2 -3
- package/src/task/autonomous-policy.ts +3 -3
- package/src/task/model.ts +2 -2
- package/src/task/production-scheduler.ts +2 -2
- package/src/task/scheduler-observability.ts +1 -0
- package/src/task/scheduler.ts +3 -2
- package/src/task/scheduling-policy.ts +2 -1
- package/src/task/trigger.ts +5 -5
- package/src/tools/git.ts +22 -4
- package/src/tools/lsp.ts +10 -8
- package/src/tools/read_image.ts +2 -1
- package/src/tools/task.ts +1 -1
- package/src/tools/web_fetch.ts +6 -2
- package/src/tools/web_search.ts +2 -1
- package/src/ui/assistant/simple.ts +42 -33
- package/src/ui/contract.ts +4 -0
- package/src/ui/footer.ts +63 -12
- package/src/ui/i18n/en.ts +14 -2
- package/src/ui/i18n/id.ts +14 -2
- package/src/ui/input/prompt-engine.ts +36 -10
- package/src/ui/render/cells.ts +320 -0
- package/src/ui/render/composer-wrap.ts +73 -0
- package/src/ui/render/detail.ts +2 -2
- package/src/ui/render/diff.ts +14 -5
- package/src/ui/render/highlight.ts +4 -4
- package/src/ui/render/ledger.ts +47 -0
- package/src/ui/render/markdown.ts +12 -5
- package/src/ui/render/session-summary.ts +50 -0
- package/src/ui/render/table-grid.ts +134 -6
- package/src/ui/render/theme.ts +49 -4
- package/src/ui/render/width.ts +91 -4
- package/src/ui/render/wrap.ts +5 -3
- package/src/ui/runtime/screen.ts +100 -22
- package/src/ui/runtime/statusline.ts +26 -0
- package/src/ui/screens/model-manager.ts +1 -1
- package/src/ui/session-state.ts +27 -1
- package/src/ui/tui/app.ts +336 -65
- package/src/ui/tui/transcript.ts +335 -104
- package/vendor/minicore/VENDOR.md +16 -12
- package/vendor/minicore/src/core/events.ts +1 -0
- package/vendor/minicore/src/core/loop.ts +11 -1
- package/vendor/minicore/src/core/session.ts +39 -0
|
@@ -1,4 +1,28 @@
|
|
|
1
|
-
# Kontrak Terminal MiniCode (TUI fullscreen — v7.
|
|
1
|
+
# Kontrak Terminal MiniCode (TUI fullscreen — v7.12, 2026-11-10)
|
|
2
|
+
|
|
3
|
+
Perubahan v7.12: footer `context` & `metrics` (window %) kini **live per step**
|
|
4
|
+
selama turn berjalan — kernel meng-emit estimasi konteks turn-store via event
|
|
5
|
+
`provider:extension` kind `context-window` SETELAH `step:completed`, dan footer
|
|
6
|
+
membacanya alih-alih terpaku pada `session.contextTokens` (committed store yang
|
|
7
|
+
hanya berubah saat `turn:completed`). Saat idle, footer kembali ke nilai
|
|
8
|
+
committed. Estimator sama sekali tidak berubah/berduplikasi — tetap satu sumber
|
|
9
|
+
(`estimateSessionContext`), hanya nilai yang dibaca saat turn aktif memakai
|
|
10
|
+
turn-store (yang tumbuh), bukan committed store (beku). Sumber: `vendor/minicore/
|
|
11
|
+
src/core/loop.ts` (emit) + `cli/tui.ts` (wiring footer).
|
|
12
|
+
|
|
13
|
+
Perubahan v7.11: thinking & jawaban di TUI dan renderer linear kini membungkus di
|
|
14
|
+
batas kata (`wrapByWidth`) — tidak memotong di tengah kata — dan baris diff ikut
|
|
15
|
+
wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
|
|
16
|
+
(v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
|
|
17
|
+
|
|
18
|
+
Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
|
|
19
|
+
sebagai **ikon gembok** `🔒` di ujung footer (setelah Permission Mode), terang
|
|
20
|
+
saat aktif (mode Auto + restrictBash) dan redup saat nonaktif. Sumbu persetujuan
|
|
21
|
+
tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
|
|
22
|
+
sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
|
|
23
|
+
bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
|
|
24
|
+
terkalibrasi yang memakai estimator yang SAMA dengan guard cutoff, sehingga
|
|
25
|
+
footer dan guard tidak pernah menghasilkan dua angka sumber berbeda.
|
|
2
26
|
|
|
3
27
|
Perubahan v7.9: input command slash tidak ditambahkan sebagai pesan transkrip;
|
|
4
28
|
aksi popup provider/model/sesi dan toggle UI tidak meninggalkan riwayat status
|
|
@@ -87,7 +111,7 @@ proteksi").
|
|
|
87
111
|
| Stream | Isi | Catatan |
|
|
88
112
|
|---|---|---|
|
|
89
113
|
| stdout | Permanent output pada non-interaktif; frame TUI saat sesi interaktif | `App` satu-satunya pemilik frame interaktif; machine output tetap murni |
|
|
90
|
-
| stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (
|
|
114
|
+
| stderr | Human-facing progress/diagnostic: ledger tool (`› …` hijau/merah), reasoning (default terlihat; `MINICODE_SHOW_THINKING=0` minimized), warning, error | Boleh transient rendering bila stderr TTY |
|
|
91
115
|
| 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()` |
|
|
92
116
|
|
|
93
117
|
Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
@@ -188,13 +212,30 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
188
212
|
- Layar tak mampu (non-TTY, `rows < 10`, `TERM=dumb`): view menolak BERSUARA
|
|
189
213
|
+ batal (fail-closed). TAK BOLEH diam.
|
|
190
214
|
- `/status` & `/history` = readout ke transkrip (bukan popup); `/help` ringkas
|
|
191
|
-
(≤
|
|
192
|
-
pilihan `/model` persist antar sesi +
|
|
215
|
+
(terkelompok ≤8 baris, penuh via `/help full`, pintasan via `/help keys`);
|
|
216
|
+
`/expand` membuka buffer isi tool; pilihan `/model` persist antar sesi +
|
|
217
|
+
struk `model: x` di transkrip.
|
|
193
218
|
|
|
194
219
|
## Invariant (nomor dipakai di peta proteksi)
|
|
195
220
|
|
|
196
221
|
1. Satu tampilan interaktif: TUI fullscreen; frame penuh tiap repaint (tepat
|
|
197
|
-
`rows` baris); scrollback utama tak tersentuh selama sesi.
|
|
222
|
+
`rows` baris); scrollback utama tak tersentuh selama sesi. Frame LOGIS tetap
|
|
223
|
+
penuh `rows` baris (hasil layar identik), namun PENULISAN FISIK ke terminal
|
|
224
|
+
boleh inkremental per SEL dan dikirim sebagai SATU `write` per frame
|
|
225
|
+
(`screen.paint` memakai diff sel terhadap frame sebelumnya; repaint
|
|
226
|
+
pertama/resize/perubahan jumlah kolom tetap `ESC[H`+`ESC[2J` clear penuh)
|
|
227
|
+
— ini murni optimasi menghapus flicker/latensi `ESC[2J` tiap keystroke,
|
|
228
|
+
bukan perubahan perilaku yang terlihat. Diff per sel menyimpan gaya sebagai
|
|
229
|
+
STATE SGR ternormalisasi (urutan kanonik, bukan riwayat sekuens), sehingga
|
|
230
|
+
sel yang identik secara visual tidak pernah ditulis ulang; glyph lebar
|
|
231
|
+
(CJK/emoji) dilindungi sel lanjutan (`cont`) agar diff tidak memotong glyph.
|
|
232
|
+
Penulisan per baris berubah: dari kolom berbeda PERTAMA sampai akhir baris
|
|
233
|
+
(prefix identik dilewati), didahului EL (`ESC[0K`) — ekor dihapus-lalu-ditulis
|
|
234
|
+
ulang supaya sisa glyph lebar / ekor baris lama tidak menempel. Tulis asing ke
|
|
235
|
+
stderr selama alt-screen hidup (mis. `[hooks] skipped …`, warning provider)
|
|
236
|
+
menandai terminal "kotor" (`statusline.consumeScreenDrift`) dan memaksa
|
|
237
|
+
repaint penuh pada paint berikutnya; tanpa ini baris yang kebetulan tak
|
|
238
|
+
berubah akan mempertahankan fragmen asing di atas diff inkremental.
|
|
198
239
|
2. stdout/stderr contract seperti tabel di atas (TTY & non-TTY deterministic).
|
|
199
240
|
3. Satu kepemilikan layar (`App`); popup satu lifecycle (`suspend`/`resume` +
|
|
200
241
|
`paintRegion`).
|
|
@@ -218,6 +259,14 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
218
259
|
|
|
219
260
|
13. Status bar: 1 baris dasar (`✦ 00.00.00 Work Mode: Discuss model cwd …
|
|
220
261
|
context Permission Mode: Auto`) dari sumber yang sama dengan angka sesi.
|
|
262
|
+
Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
|
|
263
|
+
LIVE turn-store yang di-emit kernel per step (event `provider:extension`
|
|
264
|
+
kind `context-window`, setelah `step:completed`); saat idle kembali ke
|
|
265
|
+
`session.contextTokens` (committed store). Estimator tetap satu sumber —
|
|
266
|
+
hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
|
|
267
|
+
(beku), tak ada duplikasi angka sumber (v7.12).
|
|
268
|
+
Ikon gembok `🔒` mengikuti Permission Mode di ujung kanan: terang bila
|
|
269
|
+
bash allow-list aktif (restrictBash + mode `Auto`), redup bila tidak.
|
|
221
270
|
Work Mode berada di kiri; Permission Mode cyan berada di kanan dekat
|
|
222
271
|
konteks. Pada terminal sempit, label berubah menjadi `Work:`/`Permission:`
|
|
223
272
|
atau nilai saja sebelum salah satu nilai mode dihilangkan. `✦` tetap
|
|
@@ -256,7 +305,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
256
305
|
saat turn). Composer memakai tinggi tetap: prompt saat editing, dots saat
|
|
257
306
|
reasoning, atau tool target; satu baris kosong selalu memisahkannya dari
|
|
258
307
|
footer. Proyeksi presentasi: baris running di-pin dari snapshot, elapsed
|
|
259
|
-
tetap pada ledger tool, status tool final memakai
|
|
308
|
+
tetap pada ledger tool, status tool final memakai warna + kata
|
|
260
309
|
(`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
|
|
261
310
|
anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
|
|
262
311
|
**Retry provider:** setiap `model.delta`/`reasoning.delta` live membawa
|
|
@@ -292,9 +341,12 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
292
341
|
di footer form ("batal dalam 10 dtk" — bukan countdown hidup), 10 dtk
|
|
293
342
|
berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
|
|
294
343
|
ketikan apa pun me-reset kedua timer.
|
|
295
|
-
22. Thinking terlihat: composer memakai dots clock;
|
|
296
|
-
|
|
297
|
-
|
|
344
|
+
22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
|
|
345
|
+
transkrip expanded = alir thinking ber-warna terbaca (`c.thinking`,
|
|
346
|
+
abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
|
|
347
|
+
jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
|
|
348
|
+
= bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
|
|
349
|
+
fase berakhir = commit (tak ada thinking yatim).
|
|
298
350
|
23. Approval & ask_user tercatat di transkrip (pertanyaan + keputusan) dan
|
|
299
351
|
terlihat sebelum menjawab; non-TTY = deny/null fail-closed; stdout
|
|
300
352
|
di-pipe tanpa sink TUI = deny/null (prompt tak terlihat + mencemari
|
|
@@ -303,7 +355,7 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
303
355
|
dengan id membaca satu tool, tanpa id membaca seluruh entry store yang
|
|
304
356
|
masih hidup; miss → durable sqlite → penanda retensi. Pilihan `/model`
|
|
305
357
|
persist antar sesi + struk `model: x`; `/help` ringkas (penuh via
|
|
306
|
-
`/help
|
|
358
|
+
`/help full`, pintasan via `/help keys`).
|
|
307
359
|
25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
|
|
308
360
|
backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
|
|
309
361
|
(`↑↓`, pgup/pgdn, home/end) di semua popup; hint footer akurat
|
|
@@ -434,20 +486,25 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
434
486
|
|
|
435
487
|
prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
|
|
436
488
|
berbingkai di atasnya) ·
|
|
437
|
-
status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto
|
|
489
|
+
status bar `✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto 🔒`
|
|
438
490
|
(timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
|
|
439
491
|
jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
|
|
440
|
-
dipadatkan pada terminal sempit)
|
|
492
|
+
dipadatkan pada terminal sempit; `🔒` terang = bash allow-list aktif, redup = tidak)
|
|
441
493
|
+ satu spacer sebelum footer · ledger tool
|
|
442
|
-
` › name target` (hijau) / merah saat error · error
|
|
494
|
+
` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
|
|
443
495
|
kegagalan · pesan error TUI = formatter kanonik (`formatError`,
|
|
444
496
|
`src/ui/render/errors.ts`): credential di-redaksi (bearer/key/query), escape
|
|
445
497
|
ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
|
|
446
|
-
pernah tampil · thinking: dots clock / alir
|
|
498
|
+
pernah tampil · thinking: dots clock / alir thinking terbaca · popup: konten redup di
|
|
447
499
|
belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
|
|
448
500
|
`/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
|
|
449
501
|
`/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
|
|
450
|
-
|
|
502
|
+
`/fold` = lipat aktivitas tool per turn (`MINICODE_MINIMIZE_ACTIVITY`, ON di TUI) —
|
|
503
|
+
baris ledger per-tool dirangkum jadi SATU baris ringkas (`n tools · nama · x ok · y gagal`),
|
|
504
|
+
tidak hilang diam-diam; detail dibuka via `/expand` ·
|
|
505
|
+
tabel markdown dirender kotak ber-garis (opencode-like) ber-`wrap` (konten panjang
|
|
506
|
+
tidak kepotong) + margin kiri 1 kolom; teks paragraf ber-margin kiri 1 kolom ·
|
|
507
|
+
Projection V2: `› name target … running`, ledger status ber-warna/kata,
|
|
451
508
|
retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
|
|
452
509
|
identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
|
|
453
510
|
sesuai flag ·
|
|
@@ -552,7 +609,10 @@ panjang).
|
|
|
552
609
|
Esc-1 kembalikan prefill, Esc-2 batal).
|
|
553
610
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
554
611
|
stdout-pipe tanpa sink = deny).
|
|
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).
|
|
612
|
+
- `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, ikon gembok 🔒 terang/redup).
|
|
613
|
+
- `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
|
|
614
|
+
kind `context-window` berisi `usedTokens`/`windowTokens` setelah
|
|
615
|
+
`step:completed` — sumber live-occupancy footer; nilai > 0 terbukti).
|
|
556
616
|
- `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
|
|
557
617
|
dievaluasi per pemanggilan tool; transisi BUILD/EXECUTE↔DISCUSS↔PLAN pada sesi
|
|
558
618
|
yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
|
|
@@ -615,7 +675,19 @@ panjang).
|
|
|
615
675
|
`test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
|
|
616
676
|
- `test/cli-commands.test.ts` — /status cetak, /sessions popup.
|
|
617
677
|
- `test/screen.test.ts` — I16 (pairing + paintRegion; open/paint writer failure
|
|
618
|
-
mencoba memulihkan alt-screen dan reset region)
|
|
678
|
+
mencoba memulihkan alt-screen dan reset region) + I1 (satu `write` per frame;
|
|
679
|
+
repaint penuh saat frame pertama / drift stderr / perubahan kolom, dan diff
|
|
680
|
+
inkremental per sel pada paint berikutnya yang setara — bukan clear `ESC[2J`
|
|
681
|
+
tiap keystroke).
|
|
682
|
+
- `test/cells.test.ts` — I1 (tokenizer sel grapheme + diff "tulis-ulang ekor":
|
|
683
|
+
prefix identik nol byte, dari kolom berbeda pertama sampai akhir baris ditulis
|
|
684
|
+
ulang setelah EL `ESC[0K`; start mundur ke sel pembawa glyph agar EL tak
|
|
685
|
+
membelah glyph lebar; state SGR ternormalisasi urutan kanonik — `ESC[39m`
|
|
686
|
+
membatalkan bukan menumpuk, `38;5;n`/`38;2;r;g;b` utuh, glyph lebar dilindungi
|
|
687
|
+
`cont`; fuzz 500 kasus paritas output vs referensi).
|
|
688
|
+
- `test/composer-wrap.test.ts` — I1 (wrap composer inkremental paritas dengan
|
|
689
|
+
`chunkByWidth` penuh untuk append/backspace di ujung, CJK lebar, multiline;
|
|
690
|
+
pola tak didukung → fallback).
|
|
619
691
|
- `test/screen-buffer.test.ts` — parser grid ANSI/CUP dengan pengukuran grapheme
|
|
620
692
|
yang sama dengan renderer (termasuk emoji ZWJ dua kolom).
|
|
621
693
|
- `test/tui-startup-failure.test.ts` — UI-COMPAT-01 (CLI subprocess non-TTY:
|
|
@@ -13,7 +13,7 @@ Konvensi: `file:line` menunjuk simbol yang dimaksud. Aturan repo tetap berlaku:
|
|
|
13
13
|
## 1. Jalur pipeline (9 tahap)
|
|
14
14
|
|
|
15
15
|
Tahap A — provider stream mentah: `src/providers/router.ts` (fallback +
|
|
16
|
-
`provider:text
|
|
16
|
+
`provider:text` + `provider:extension`), `src/providers/guards.ts:32`
|
|
17
17
|
(timeout + text-cap + stream-guard tunggal), adapter `anthropic.ts`,
|
|
18
18
|
`responses.ts`, `effort.ts`. Dirakit di `src/app/provider-layer.ts`.
|
|
19
19
|
|
|
@@ -23,7 +23,7 @@ reasoning/usage/error, `context:compacted` reason `pressure:*`/`recovery`,
|
|
|
23
23
|
`step:started/completed`), `executor.ts` (`execution:started/completed`),
|
|
24
24
|
`session.ts` (`turn:completed` HANYA di jalur sukses).
|
|
25
25
|
|
|
26
|
-
Tahap C — raw runtime/content contract: `src/ui/contract.ts
|
|
26
|
+
Tahap C — raw runtime/content contract: `src/ui/contract.ts` (`UiEvent`) masih
|
|
27
27
|
mencerminkan bentuk event kernel untuk streaming konten dan transport. Ledger,
|
|
28
28
|
status, lifecycle, dan keputusan user-facing melalui `PresentationEvent` +
|
|
29
29
|
`PresentationPolicy` dari `cli/setup.ts`; `attachSimpleLogger` dan
|
|
@@ -39,7 +39,8 @@ memprojection seluruh `DomainEventType` melalui `toPresentationEvent()`;
|
|
|
39
39
|
activity/turn, running pin, envelope machine) yang di-inject ke renderer sebagai
|
|
40
40
|
`PresentationPolicy`. Lihat kontrak aktif di `docs/OUTPUT_EVENT_MODEL.md`.
|
|
41
41
|
|
|
42
|
-
Tahap D — logger utama `src/ui/assistant/simple.ts:
|
|
42
|
+
Tahap D — logger utama `src/ui/assistant/simple.ts` (`attachSimpleLogger`):
|
|
43
|
+
append-only
|
|
43
44
|
scrollback, tanpa alternate screen. `provider:text` → `sanitizeAnsi` PER CHUNK
|
|
44
45
|
→ `streamBuffer` → `flushBuf` (line-buffered) → `flushLine` (fence-state +
|
|
45
46
|
`decorateMarkdown` + `formatWrapped`) → `stdout`. Jawaban bisa minimize
|
|
@@ -91,7 +92,7 @@ mempertahankan source sanitized pada non-TTY. `exec --json`/ACP tidak melewati
|
|
|
91
92
|
renderer ini.
|
|
92
93
|
Tahap I — view murni vs controller: `src/ui/screens/` (props + callback,
|
|
93
94
|
tanpa IO) digerakkan `cli/` (`tui.ts`, `commands.ts`, `wizard.ts`,
|
|
94
|
-
`
|
|
95
|
+
`model-manager.ts`, `provider-manager.ts`, `src/ui/approval/prompt.ts` via DI `ask`,
|
|
95
96
|
`setupWhenEmpty`, `setSubAgentSessionFactory`).
|
|
96
97
|
|
|
97
98
|
## 2. Kontrak Event → UI
|
|
@@ -111,11 +112,11 @@ I = bisa diinterupsi, L = bisa tiba setelah completion.
|
|
|
111
112
|
| permission request | executor → `ask` DI | header stdout + `askLine y/a/n`, fail-closed non-TTY | tidak | tidak | tidak | ya (deny) | tidak |
|
|
112
113
|
| permission denied | executor | error tool penuh, tak pernah minimize + reason | tidak | tidak | tidak | tidak | tidak |
|
|
113
114
|
| 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
|
|
115
|
+
| error provider | provider extension | `pendingError` consume-once → satu pesan error berwarna oleh driver | tidak | tidak (E15) | tidak | ya | tidak |
|
|
115
116
|
| warning | budget/recovery/verify | `[budget]`/`[recovery]`/`[verify]` kuning stderr | tidak | tidak (warned80 sekali) | tidak | tidak | tidak |
|
|
116
117
|
| completion | kernel loop | flush + `finalizeAnswer` + footer idle | tidak | tidak | tidak | tidak | tidak |
|
|
117
118
|
| abort | user/Esc | `(stopped)` + cleanup `finally` | tidak | tidak | tidak | — | tidak |
|
|
118
|
-
| timeout | kernel `createTimeout` |
|
|
119
|
+
| timeout | kernel `createTimeout` | `timeout` (berwarna) + turn dibuang transaksional | tidak | tidak | tidak | — | ya (late work ke turnStore privat, dibuang) |
|
|
119
120
|
| budget exceeded | watcher/driver | `[budget] … stopping turn` + abort ber-kind | tidak | tidak (fire-once) | tidak | — | tidak |
|
|
120
121
|
| provider failure | recovery policy | retry/compact/throw deterministik; cap retryAfter 30 dtk | tidak | tidak | tidak | tidak | tidak |
|
|
121
122
|
|
|
@@ -123,7 +124,7 @@ Mismatch yang dicari, hasil: raw EventBus tetap ada untuk konten/streaming,
|
|
|
123
124
|
tetapi keputusan user-facing kini membaca policy yang sama (raw ledger TUI
|
|
124
125
|
dihapus di Phase 8). Buffer jawaban live TUI dibatasi 1.000.000 karakter;
|
|
125
126
|
layout paint memakai satu proyeksi transcript dan cache render jawaban.
|
|
126
|
-
`cli/setup.ts
|
|
127
|
+
`cli/setup.ts` (`toPresentationEvent()`) memproyeksikan seluruh `DomainEventType` secara
|
|
127
128
|
exhaustive; TUI memakai `describeActivity`/`matchTurn`/`elapsedVisible` via
|
|
128
129
|
injeksi, linear memakai deskripsi + `activityFor` untuk label turn-status, dan
|
|
129
130
|
machine memakai `toMachineEnvelope`. `bus-debug.ts` hanya debug subscription.
|
|
@@ -179,7 +180,8 @@ pasca-reflow (terbukti model + ConPTY: reflow milik konsumen).
|
|
|
179
180
|
Dijaga `test/ansi-fragmentation.test.ts`
|
|
180
181
|
(termasuk properti semua-titik-belah ≡ whole-string),
|
|
181
182
|
`test/non-tty-output.test.ts`, `test/thinking-truncation.test.ts`,
|
|
182
|
-
`test/
|
|
183
|
+
`test/tui-format.test.ts` (stdout/stderr + ledger tool), `test/footer-render.test.ts`
|
|
184
|
+
(footer),
|
|
183
185
|
`test/input-resize.test.ts` (gagal di kode lama: CUP ke anchor basi).
|
|
184
186
|
|
|
185
187
|
Batas yang TERVERIFIKASI BENAR (bukti harness + 178 test UI hijau):
|
|
@@ -202,3 +204,40 @@ nyata di audit ini. Chaos kombinasi (stream+resize+abort serentak di TTY)
|
|
|
202
204
|
dan soak 100+ turn multitool belum dijalankan. Sub-agent tanpa view khusus:
|
|
203
205
|
indukan dibedakan hanya dari nama tool (cukup untuk 1 level, belum diuji
|
|
204
206
|
visual untuk delegasi bertingkat — yang memang dilarang: tanpa nesting).
|
|
207
|
+
|
|
208
|
+
## 6. Optimasi latensi ketik & biaya salin (fase 1–4, pasca-audit)
|
|
209
|
+
|
|
210
|
+
Ringkasan: TUI tetap penuh `rows` baris secara LOGIS; yang diperkecil hanyalah
|
|
211
|
+
byte FISIK yang ditulis. Kontrak perilaku user-visible tidak berubah, jadi
|
|
212
|
+
`TERMINAL_CONTRACT.md` I1 adalah sumber kebenaran.
|
|
213
|
+
|
|
214
|
+
- **Fase 1 — satu `write` per frame.** `screen.paint` merakit seluruh frame
|
|
215
|
+
(masuk blok sinkronis `ESC[?2026h`/`ESC[?2026l`) menjadi SATU string lalu
|
|
216
|
+
menulisnya sekali ke `process.stdout`. Menghapus sejumlah `write` kecil per
|
|
217
|
+
frame yang membuat ConPTY membangun ulang potongan.
|
|
218
|
+
- **Fase 2 — diff per sel.** `src/ui/render/cells.ts` memecah baris menjadi sel
|
|
219
|
+
(grapheme + STATE SGR ternormalisasi) dan menghasilkan byte minimal:
|
|
220
|
+
prefix identik dilewati (nol byte), lalu dari kolom berbeda PERTAMA sampai
|
|
221
|
+
akhir baris ditulis ulang setelah EL `ESC[0K`. Start mundur ke sel pembawa
|
|
222
|
+
glyph agar EL tidak membelah glyph lebar; kolom lanjutan ditandai `cont`.
|
|
223
|
+
Frame pertama / resize / perubahan jumlah kolom tetap `ESC[H`+`ESC[2J`.
|
|
224
|
+
- **Fase 2b — invalidasi drift.** Tulis asing ke stderr selama alt-screen hidup
|
|
225
|
+
(mis. `[hooks] skipped …`, warning provider) mengotori buffer di balik
|
|
226
|
+
pelacakan diff; `statusline` menandainya (`consumeScreenDrift`) dan layar
|
|
227
|
+
memaksa repaint penuh sekali. `beginInteractiveScreen` memasang wrapper
|
|
228
|
+
stderr saat depth 0→1 supaya sinyal ini terpasang bahkan tanpa owner transient.
|
|
229
|
+
Tanpa ini baris yang kebetulan tak berubah akan mempertahankan fragmen asing.
|
|
230
|
+
- **Fase 3 — hot path editor.** `screen.moveCursor` untuk fast-path kursor-saja
|
|
231
|
+
(tanpa merakit ulang frame); `prompt-engine.ts` memakai memo grapheme 1-entri
|
|
232
|
+
+ fast path ASCII; `composer-wrap.ts` melakukan wrap inkremental saat append/
|
|
233
|
+
backspace di ujung, jatuh ke `chunkByWidth` penuh bila pola tak didukung.
|
|
234
|
+
- **Fase 4 — biaya salin.** `transcript.selectionText` memakai binary search
|
|
235
|
+
(`orderLowerBound`) + `selectionIsEmpty` murah; guard OSC 52 berbasis byte
|
|
236
|
+
(`MAX_CLIPBOARD_BYTES`/`MAX_SELECTION_BYTES` = 256 KiB) di `simple.ts` dan
|
|
237
|
+
`app.ts`; `/copy` dibatasi total byte dan melaporkan `tui.copyTooLarge`.
|
|
238
|
+
|
|
239
|
+
Penjaga: `test/cells.test.ts` (paritas diff vs tulis-penuh + minimalitas),
|
|
240
|
+
`test/composer-wrap.test.ts` (paritas wrap inkremental), `test/screen.test.ts`
|
|
241
|
+
(satu `write`/frame, repaint penuh pada drift/frame pertama, diff setara),
|
|
242
|
+
plus `test/pty.test.ts` / `test/screen-buffer.test.ts` untuk verifikasi buffer
|
|
243
|
+
nyata. Angka hasil historis (laporan sebelumnya) tetap berstatus historical.
|
package/docs/agents.md
CHANGED
|
@@ -18,7 +18,7 @@ Restriksi anak yang **selalu** berlaku: `delegate_task`, `git_commit`, memory/to
|
|
|
18
18
|
|
|
19
19
|
## Kenapa dibatasi
|
|
20
20
|
|
|
21
|
-
Sub-agent menjalankan task tanpa Anda di depan layar. Karena itu kemampuan commit dan
|
|
21
|
+
Sub-agent menjalankan task tanpa Anda di depan layar. Karena itu kemampuan commit dan tool dinamis MCP tidak diteruskan; mode `explore` dan WorkMode ketat hanya memberi tool eksplorasi (tool MCP built-in pun tersaring). Mode `plan` di bawah `BUILD` tetap dapat mengubah file, menjalankan tool dasar, dan memakai tool MCP built-in bila diotorisasi, sehingga hasilnya harus ditinjau parent.
|
|
22
22
|
|
|
23
23
|
## Recovery
|
|
24
24
|
|
package/docs/architecture.md
CHANGED
|
@@ -12,7 +12,7 @@ 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/
|
|
15
|
+
Pin source kernel ada di [catatan vendor MiniCore](https://github.com/minilabs-id/minicode/blob/main/vendor/minicore/VENDOR.md):
|
|
16
16
|
`0d33571`. Impor kernel aplikasi hanya melalui `#minicore`.
|
|
17
17
|
|
|
18
18
|
Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
|
|
@@ -41,9 +41,10 @@ dutinya:
|
|
|
41
41
|
|
|
42
42
|
Kompaksi bersifat lossy, termasuk setelah restart. `persistCurrent` mengirim
|
|
43
43
|
history yang sudah dipadatkan ke `shrinkThreadHistory`, yang menghapus lalu
|
|
44
|
-
menulis ulang baris `messages`;
|
|
45
|
-
|
|
46
|
-
di jalur LLM, dibatasi, opt-out, dan
|
|
44
|
+
menulis ulang baris `messages`; fold mekanis meringkas pesan lama sambil
|
|
45
|
+
**mempertahankan** hasil tool (head-terpotong per peran) — bukan membuangnya.
|
|
46
|
+
Ringkasan ke vector memory hanya dibuat di jalur LLM, dibatasi, opt-out, dan
|
|
47
|
+
best-effort. Karena itu jangan menganggap
|
|
47
48
|
semua fakta lama tetap dapat dipulihkan dari sesi atau vector store; state
|
|
48
49
|
penting harus dicatat di task, file, atau artefak verifikasi yang otoritatif.
|
|
49
50
|
|
|
@@ -119,18 +120,19 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
|
|
|
119
120
|
| stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY |
|
|
120
121
|
| Keduanya | Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe |
|
|
121
122
|
|
|
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.
|
|
123
|
+
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; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. 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.
|
|
123
124
|
|
|
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
|
|
125
|
+
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` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
|
|
125
126
|
|
|
126
127
|
## Modul kunci
|
|
127
128
|
|
|
128
129
|
- `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.
|
|
129
130
|
|
|
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`.
|
|
131
|
+
- `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `ledger.ts` (status word/glyph/paint + run-marker bersama untuk TUI & linear), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `cells.ts` (framebuffer sel grapheme+SGR + diff "tulis-ulang ekor" untuk penulisan inkremental), `composer-wrap.ts` (wrap composer inkremental), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
|
|
131
132
|
- `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`.
|
|
133
|
+
- `src/policy/`: `context.ts` (estimator sadar-densitas kode/JSON + kalibrasi usage), `context-window.ts` + `context-window-catalog.ts` (resolve window: config → katalog → models.dev → default 128K alias → 32K), `bpe.ts` + `tokenizer-registry.ts` (tokenizer BPE presisi on-demand dari HuggingFace, cache lokal, fallback densitas), `compaction.ts` (kompaksi LLM + mekanikal, anti-drift/anti-thrash, prefer provider sesi), `usage.ts`/`pricing.ts` (estimas biaya + models.dev).
|
|
132
134
|
- `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).
|
|
133
|
-
- `src/ui/screens/`: view murni `picker/
|
|
135
|
+
- `src/ui/screens/`: view murni `picker/wizard/model-manager/provider-manager`.
|
|
134
136
|
- `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
|
|
135
137
|
- `src/daemon/`: hosted-session runtime, discovery, framed IPC/capabilities, replay, approval brokerage, child supervision, dan ordered shutdown; composition melalui `cli/commands/daemon.ts`.
|
|
136
138
|
- `src/runtime/`: admission dan execution kernel aplikasi (`dispatch.ts`, `execution-kernel.ts`, `production-execution.ts`) serta recovery (`recovery.ts`).
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# Autonomous Scheduler (eksperimental)
|
|
2
|
+
|
|
3
|
+
> **Eksperimental.** Opt-in per invokasi, nonaktif secara bawaan, dan dipicu manual.
|
|
4
|
+
> Tidak ada timer latar (no background timer). Tidak ada yang berjalan kecuali Anda memintanya.
|
|
5
|
+
|
|
6
|
+
Scheduler mengevaluasi task graph Anda dan, bila ada task yang siap, menyerahkannya
|
|
7
|
+
ke sesi MiniCode otonom yang mengerjakannya tanpa Anda.
|
|
8
|
+
|
|
9
|
+
## 1. Aktifkan
|
|
10
|
+
|
|
11
|
+
Tambahkan flag ke sembarang invokasi:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
minicode --enable-scheduler
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Itu satu-satunya cara menyalakannya. Tidak ada kunci config, tidak ada variabel
|
|
18
|
+
environment, dan tidak ada cara mewarisinya dari proses induk — flag yang diketik
|
|
19
|
+
di baris perintah adalah satu-satunya mekanismenya. `--enable-scheduler=false`
|
|
20
|
+
**tidak** mengaktifkannya; flag tidak punya bentuk nilai, dan bare flag adalah
|
|
21
|
+
satu-satunya bentuk yang dihitung.
|
|
22
|
+
|
|
23
|
+
Saat startup dengan flag, proses mengakuisisi lease eksklusif pada sesi Anda.
|
|
24
|
+
Bila proses lain sudah memegang lease itu, startup gagal dengan jelas alih-alih
|
|
25
|
+
menjalankan scheduler kedua di atas sesi yang sama.
|
|
26
|
+
|
|
27
|
+
## 2. Picu
|
|
28
|
+
|
|
29
|
+
Penjadwalan bersifat **manual**. Tidak ada yang berjalan sendiri:
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
/scheduler run
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Ini menjalankan tepat satu siklus penjadwalan:
|
|
36
|
+
|
|
37
|
+
- baca ulang task graph,
|
|
38
|
+
- pilih satu task yang siap (bila ada),
|
|
39
|
+
- klaim secara durable,
|
|
40
|
+
- jalankan satu turn otonom di atasnya,
|
|
41
|
+
- laporkan hasilnya.
|
|
42
|
+
|
|
43
|
+
Bila tidak ada yang siap, siklus berakhir dengan `no task was ready` dan tidak ada
|
|
44
|
+
pekerjaan yang dibuat. Jika sebuah task menjadi siap *setelah* itu, ia tetap
|
|
45
|
+
pending sampai Anda menjalankan `/scheduler run` lagi. Tidak ada polling, tidak
|
|
46
|
+
ada timer, dan tidak ada perulangan latar — ini kontrak saat ini, bukan kelalaian.
|
|
47
|
+
|
|
48
|
+
Perintah menunggu siklus selesai, lalu mencetak hasilnya.
|
|
49
|
+
|
|
50
|
+
## 3. Amati
|
|
51
|
+
|
|
52
|
+
```text
|
|
53
|
+
/scheduler status
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Melaporkan state saat ini, sesi yang dimilikinya, apakah lease dipegang, counter
|
|
57
|
+
untuk proses ini, dan lima event lifecycle terakhir.
|
|
58
|
+
|
|
59
|
+
Anda akan melihat satu dari lima state:
|
|
60
|
+
|
|
61
|
+
| State | Artinya |
|
|
62
|
+
| --- | --- |
|
|
63
|
+
| `scheduler OFF` | Flag tidak diberikan. Tidak ada scheduler. |
|
|
64
|
+
| `scheduler ON, idle` | Aktif, memegang lease, menunggu `/scheduler run`. |
|
|
65
|
+
| `scheduler ON, executing` | Sebuah siklus sedang berjalan. |
|
|
66
|
+
| `scheduler ON but STOPPED` | Dihentikan, dimatikan, atau lease-nya hilang. Tidak akan menjadwalkan lagi di proses ini. |
|
|
67
|
+
| `scheduler ON, last cycle failed` | Siklus gagal. Alasannya ada di baris berikutnya. |
|
|
68
|
+
|
|
69
|
+
Event lifecycle juga muncul inline di transkrip sebagai baris `[scheduler] ...`.
|
|
70
|
+
Itu entri sistem, bukan percakapan — tidak pernah dikirim ke model dan tidak
|
|
71
|
+
pernah muncul sebagai output tool.
|
|
72
|
+
|
|
73
|
+
Aktivitas bersifat in-memory dan reset saat proses keluar. State task yang
|
|
74
|
+
durable bertahan; diagnostik tidak.
|
|
75
|
+
|
|
76
|
+
## 4. Hentikan
|
|
77
|
+
|
|
78
|
+
```text
|
|
79
|
+
/scheduler stop
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Ini mencegah trigger berikutnya, mencegah klaim baru, membatalkan turn otonom
|
|
83
|
+
yang masih berjalan, dan melepas lease sesi agar proses lain bisa mengambilnya.
|
|
84
|
+
|
|
85
|
+
Menghentikan dua kali tidak masalah — panggilan kedua menyatakannya dan tidak
|
|
86
|
+
melakukan apa-apa.
|
|
87
|
+
|
|
88
|
+
Sekali dihentikan, scheduler tidak bisa di-start ulang. **Keluar dan mulai proses
|
|
89
|
+
baru** dengan flag untuk menjadwalkan lagi. Tidak ada toggle in-app karena alasan
|
|
90
|
+
yang sama `/scheduler stop` satu arah: menghentikan turn yang berjalan adalah
|
|
91
|
+
shutdown, bukan pengaturan.
|
|
92
|
+
|
|
93
|
+
## 5. Pulihkan
|
|
94
|
+
|
|
95
|
+
Bila sebuah proses mati sambil memegang lease, lease tidak dilepas. Penggantinya
|
|
96
|
+
cukup menunggu:
|
|
97
|
+
|
|
98
|
+
- durasi lease 5 menit
|
|
99
|
+
- diperbarui tiap menit selama proses hidup
|
|
100
|
+
|
|
101
|
+
Jadi scheduler yang crash membebaskan sesinya otomatis dalam 5 menit. Untuk
|
|
102
|
+
memulihkan segera, hapus sesinya (`/sessions`), yang membatalkannya langsung.
|
|
103
|
+
|
|
104
|
+
Bila lease hilang saat berjalan (proses lain mengambil alih, atau sesi dihapus),
|
|
105
|
+
scheduler **self-dispose**. Ia tidak akan mengklaim atau mengeksekusi apa pun
|
|
106
|
+
lagi, dan alasannya muncul di `/scheduler status`. Ini disengaja: scheduler yang
|
|
107
|
+
tidak bisa membuktikan kepemilikan sesi lebih baik tidak berbuat apa-apa daripada
|
|
108
|
+
balapan dengan proses yang bisa.
|
|
109
|
+
|
|
110
|
+
## 6. Nonaktifkan
|
|
111
|
+
|
|
112
|
+
Tidak ada yang perlu dimatikan. Hapus flag dan proses berikutnya tidak punya
|
|
113
|
+
scheduler sama sekali — tanpa lease, tanpa store handle, tanpa resource latar.
|
|
114
|
+
Menghentikan yang sedang berjalan: `/scheduler stop`, atau cukup keluar.
|
|
115
|
+
|
|
116
|
+
## Yang boleh dilakukan sesi otonom
|
|
117
|
+
|
|
118
|
+
Turn otonom berjalan di bawah kebijakan **read-only**. Set tool adalah allow-list
|
|
119
|
+
tetap berisi kapabilitas read-only — baca file, search, inspeksi git, query LSP.
|
|
120
|
+
Tulis, edit, eksekusi, dan apa pun yang mengambil network ditolak, dan tidak ada
|
|
121
|
+
yang bisa memperlebar di jalur trigger: allow-list ditegakkan saat executor
|
|
122
|
+
dibangun, sehingga konfigurasi yang mencoba memperlebar gagal di startup alih-alih
|
|
123
|
+
berjalan dengan lebih banyak kekuatan.
|
|
124
|
+
|
|
125
|
+
Turn otonom tidak meminta persetujuan. Tidak ada operator di loop, itulah sebabnya
|
|
126
|
+
kebijakannya sempit, bukan permisif.
|
|
127
|
+
|
|
128
|
+
## Batasan
|
|
129
|
+
|
|
130
|
+
- Satu siklus per `/scheduler run`; tanpa penjadwalan berulang.
|
|
131
|
+
- Tanpa langkah persetujuan antara klaim dan eksekusi. Kebijakan readonly adalah
|
|
132
|
+
batasnya.
|
|
133
|
+
- Diagnostik per-proses dan hilang saat keluar.
|
|
134
|
+
- Dua proses tidak bisa menjadwalkan sesi yang sama sekaligus; yang kedua gagal
|
|
135
|
+
tertutup.
|
|
136
|
+
- Eksperimental. Antarmukanya bisa berubah.
|
|
137
|
+
|
|
138
|
+
## Terkait
|
|
139
|
+
|
|
140
|
+
- [CLI](cli.md) — referensi lengkap flag.
|
|
141
|
+
- [Arsitektur](architecture.md) — di mana scheduler berada.
|
|
142
|
+
- [Open Work](P14_OPEN_WORK.md) — pekerjaan lintas sesi yang diteruskan scheduler.
|
package/docs/choosing-mode.md
CHANGED
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
|
|
4
4
|
|
|
5
|
-
1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/
|
|
5
|
+
1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/perencanaan), `BUILD` (implementasi).
|
|
6
6
|
2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
|
|
7
7
|
3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
|
|
8
8
|
|
|
9
|
-
Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya.
|
|
9
|
+
Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya — **kecuali mode `unrestricted`** (lihat baris terakhir tabel).
|
|
10
10
|
|
|
11
11
|
## Kalau tujuan Anda X → gunakan Y
|
|
12
12
|
|
|
@@ -18,6 +18,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
18
18
|
| Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
|
|
19
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
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
|
+
| Full akses tanpa pembatas (VM/VPN tepercaya) | `/unrestric` (perintah TUI tersembunyi, per-sesi) | Melepas jail + bash-guard + sandbox/allowlist; gerbang = kepercayaan operator; gembok footer jadi 🔓 terang (bukan redup) |
|
|
21
22
|
|
|
22
23
|
## Rule of thumb
|
|
23
24
|
|
|
@@ -26,6 +27,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
26
27
|
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
28
|
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.
|
|
28
29
|
5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
|
|
30
|
+
6. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — full akses berarti model bisa menyentuh file apa pun di host. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
|
|
29
31
|
|
|
30
32
|
## Tradeoff yang jujur
|
|
31
33
|
|
package/docs/cli.md
CHANGED
|
@@ -24,7 +24,7 @@ Semua cara menjalankan Minicode: interaktif, sekali jalan, pipe, dan otomasi CI
|
|
|
24
24
|
| `minicode skills list` | Daftar skill terpasang |
|
|
25
25
|
| `minicode sessions list` | Riwayat sesi |
|
|
26
26
|
| `minicode memory status [--json]` | Statistik vector RAG (rows, size, hit-rate) |
|
|
27
|
-
| `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only;
|
|
27
|
+
| `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only, bersihkan baris superseded; hierarki `MEMORY.md` root/`CLAUDE.md` tak disentuh) |
|
|
28
28
|
| `minicode doctor [--json]` | Diagnosis lokal |
|
|
29
29
|
| `minicode mcp serve` | Ekspos minicode sebagai MCP server |
|
|
30
30
|
| `minicode openwork [inventory\|context\|export\|merge]` | Baca, susun konteks, ekspor, atau deduplikasi pekerjaan lintas sesi; aksi tidak menjalankan task |
|
|
@@ -51,7 +51,7 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
|
|
|
51
51
|
| `--model <name>` | Override model (`providerId::model` paksa provider) |
|
|
52
52
|
| `--provider <id>` | Paksa provider id agnostik |
|
|
53
53
|
| `--resume <id>` | Lanjutkan history yang tersimpan; setelah kompaksi, bagian lama dapat berupa ringkasan + tail |
|
|
54
|
-
| `--timeout <ms>` | Hard deadline per prompt (default
|
|
54
|
+
| `--timeout <ms>` | Hard deadline per prompt (default 3600000 = 1 jam; `0` = Infinity; jalur `exec` tetap 15 menit). Sesi yang idle tidak menghabiskan deadline prompt berikutnya. |
|
|
55
55
|
| `--cwd <path>` | Workspace root untuk tool file & jail |
|
|
56
56
|
| `--allow-local-config` | Percayai `.minicode/config.json` + allowlist lokal (default: diabaikan) |
|
|
57
57
|
| `--max-steps <n>` | Batas langkah tool (default 50) |
|
|
@@ -63,11 +63,13 @@ Subcommand di-route di `cli/router.ts` (`stats`, `sessions`, `mcp`, `config`, `s
|
|
|
63
63
|
|
|
64
64
|
Tanpa flag, MiniCode memakai `providers[].contextWindows` dari konfigurasi.
|
|
65
65
|
Jika model/gateway tidak punya metadata itu, MiniCode memakai fallback
|
|
66
|
-
32.000 token
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
66
|
+
32.000 token (model tak dikenal) atau default konservatif 128K untuk alias
|
|
67
|
+
router (`auto`/`best`/...), lalu memberi peringatan saat sesi mulai. Gunakan
|
|
68
|
+
batas model yang tepat pada config atau flag; batas yang terlalu kecil memicu
|
|
69
|
+
kompaksi dini, sedangkan batas yang terlalu besar berisiko ditolak provider.
|
|
70
|
+
Batas berubah otomatis saat `/model` mengganti model. MiniCode juga membatasi
|
|
71
|
+
keluaran stream berdasarkan ruang tersisa setelah system prompt, tools, dan
|
|
72
|
+
riwayat dihitung.
|
|
71
73
|
|
|
72
74
|
Di TUI, **Tab** memutar Work Mode (`Discuss` → `Plan` → `Build`) dan **Shift+Tab** meng-toggle Permission Mode (`Auto` ↔ `Ask`). `/mode <AUTO|ASK>` mengubah persetujuan; `/work-mode <DISCUSS|PLAN|BUILD>` mengubah operating mode. Footer menampilkan Work Mode di kiri dan Permission Mode berwarna cyan di kanan, dekat penggunaan konteks; pada terminal sempit label dipadatkan.
|
|
73
75
|
|
|
@@ -115,7 +117,7 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
|
|
|
115
117
|
|
|
116
118
|
## Anti-injeksi flag
|
|
117
119
|
|
|
118
|
-
`cli/args.ts
|
|
120
|
+
`cli/args.ts` (`hasFlag`/`getArg`) berhenti di prompt word pertama: prompt `"review --allow-all"` tidak mengaktifkan flag. `--cwd`/value-flag setelah nama subcommand diparse per-subcommand agar tidak menembus boundary prompt.
|
|
119
121
|
|
|
120
122
|
## Exit codes
|
|
121
123
|
|
|
@@ -123,6 +125,6 @@ Skema, contoh, scope global/lokal, dan lokasi seluruh data ada di [Config — Fi
|
|
|
123
125
|
|---|---|
|
|
124
126
|
| `0` | Sukses, atau help yang memang diminta |
|
|
125
127
|
| `1` | Gagal runtime: provider error, budget lewat, turn gagal, setup gagal |
|
|
126
|
-
| `2` | Salah pakai: argumen hilang/malformed, subcommand asing |
|
|
128
|
+
| `2` | Salah pakai: argumen hilang/malformed, subcommand bersarang asing (token top-level asing malah jadi prompt one-shot) |
|
|
127
129
|
|
|
128
130
|
Lookup yang gagal (provider/skill/sesi tak dikenal) = `1`: itu kegagalan operasi, bukan pemakaian. Skrip cukup cek `!= 0` untuk gagal; cek `== 2` untuk spesifik salah pakai.
|
package/docs/concepts.md
CHANGED
|
@@ -12,12 +12,12 @@ Minicode itu apa, kenapa dibangun begitu, dan kenapa beberapa hal sengaja tidak
|
|
|
12
12
|
|
|
13
13
|
## Loop ReAct
|
|
14
14
|
|
|
15
|
-
Setiap prompt berjalan sebagai loop `Thought → Action → Observation` sampai jawaban final, batas `--max-steps` (default 50), atau `--timeout` (default
|
|
15
|
+
Setiap prompt berjalan sebagai loop `Thought → Action → Observation` sampai jawaban final, batas `--max-steps` (default 50), atau `--timeout` (default 1 jam). Model menerima system prompt berisi `# Environment` (cwd + platform), repo-map ringkas, dan memory yang relevan — lalu memilih tool, melihat hasilnya, dan memilih langkah berikutnya. Tidak ada grafik alur tersembunyi: apa pun yang agent lakukan tampil sebagai ledger di layar.
|
|
16
16
|
|
|
17
17
|
## Shell-first: non-interaktif polos, interaktif fullscreen
|
|
18
18
|
|
|
19
|
-
Minicode sengaja **tanpa
|
|
20
|
-
|
|
19
|
+
Minicode sengaja **tanpa library TUI pihak ketiga** (tanpa Ink/React; TUI-nya
|
|
20
|
+
ditulis sendiri) dan membagi dua jalur secara tegas:
|
|
21
21
|
|
|
22
22
|
- **Non-interaktif** (one-shot prompt, `exec`, pipe/redirect/CI, `TERM=dumb`):
|
|
23
23
|
output mengalir **append-only ke scrollback** — hasil agen adalah artefak
|
|
@@ -35,8 +35,8 @@ Detail lengkap + kontrak FROZEN-nya di [Kontrak Terminal](terminal.md).
|
|
|
35
35
|
Beberapa keputusan desain lahir dari tidak mau berpura-pura:
|
|
36
36
|
|
|
37
37
|
- **Angka tidak ditulis permanen** di dokumentasi — jalankan `bun test` / `bun run gate:coverage` / lihat CI. Halaman yang mengklaim jumlah test akan usang begitu dipush.
|
|
38
|
-
- **Kegagalan dilaporkan apa adanya**: `auth login` menampilkan error server tanpa dipercantik;
|
|
39
|
-
- **Ukur, bukan klaim**: bash-guard divalidasi korpus serangan +
|
|
38
|
+
- **Kegagalan dilaporkan apa adanya**: `auth login` menampilkan error server tanpa dipercantik; `minicode sync`/`/sync` jujur `{updated, failed}`; sandbox yang tidak tersedia **tidak** dilabeli aman — default turun ke `allowlist` dengan alasan dicetak sekali.
|
|
39
|
+
- **Ukur, bukan klaim**: bash-guard divalidasi korpus serangan + perintah sah (jalankan `bun run gate:bash`). Lihat [Keamanan](security.md).
|
|
40
40
|
- **Skor benchmark dilaporkan apa adanya** beserta batas validitasnya (lingkungan, ukuran sampel). Lihat [Verify & Benchmark](verify-benchmark.md).
|
|
41
41
|
|
|
42
42
|
## Zero-dep runtime
|