minicode-ai 0.22.0 → 0.25.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 +2 -2
- package/cli/commands.ts +10 -0
- package/cli/index.ts +11 -0
- package/cli/setup.ts +64 -33
- package/cli/tui.ts +29 -3
- package/docs/README.md +2 -2
- package/docs/SUMMARY.md +10 -19
- package/docs/TERMINAL_CONTRACT.md +119 -32
- package/docs/architecture.md +1 -1
- package/docs/autonomous-scheduler.md +283 -2
- package/docs/choosing-mode.md +4 -4
- package/docs/concepts.md +39 -3
- package/docs/config.md +90 -4
- package/docs/environment.md +6 -0
- package/docs/getting-started.md +58 -2
- package/docs/repl.md +1 -1
- package/docs/security.md +49 -2
- package/docs/tools.md +2 -1
- package/package.json +2 -36
- package/src/app/provider-layer.ts +1 -1
- package/src/app/session.ts +129 -20
- package/src/config.ts +102 -2
- package/src/constants.ts +32 -4
- package/src/lib/safe-open.ts +21 -12
- package/src/memory/vector.ts +0 -31
- package/src/policy/compaction.ts +27 -0
- package/src/policy/context-budget.ts +132 -0
- package/src/policy/context-escalation.ts +140 -0
- package/src/policy/context-window.ts +14 -9
- package/src/policy/context.ts +10 -1
- package/src/policy/microcompact.ts +162 -0
- package/src/policy/no-progress.ts +1 -1
- package/src/policy/permission.ts +5 -0
- package/src/policy/scrub.ts +15 -2
- package/src/policy/tool-contract.ts +11 -9
- package/src/presentation/reducer.ts +1 -0
- package/src/providers/anthropic.ts +17 -3
- package/src/providers/detect.ts +155 -13
- package/src/providers/provision.ts +92 -1
- package/src/providers/responses.ts +13 -1
- package/src/session/persistence.ts +56 -0
- package/src/task/autonomous-policy.ts +7 -0
- package/src/task/graph-validate.ts +1 -1
- package/src/task/session-authority.ts +0 -5
- package/src/task/store.ts +0 -4
- package/src/tools/ask_user.ts +14 -1
- package/src/tools/bash.ts +57 -9
- package/src/tools/context.ts +10 -0
- package/src/tools/delete_file.ts +3 -2
- package/src/tools/edit.ts +5 -4
- package/src/tools/git.ts +70 -12
- package/src/tools/glob.ts +13 -5
- package/src/tools/grep.ts +26 -10
- package/src/tools/index.ts +3 -2
- package/src/tools/lsp.ts +15 -9
- package/src/tools/move_file.ts +4 -3
- package/src/tools/patch.ts +5 -4
- package/src/tools/read_file.ts +3 -2
- package/src/tools/read_image.ts +3 -2
- package/src/tools/task.ts +1 -0
- package/src/tools/todo.ts +4 -8
- package/src/tools/write_file.ts +4 -3
- package/src/ui/approval/prompt.ts +226 -77
- package/src/ui/assistant/simple.ts +1 -1
- package/src/ui/footer.ts +41 -29
- package/src/ui/i18n/en.ts +23 -4
- package/src/ui/i18n/id.ts +25 -4
- package/src/ui/input/input.ts +2 -2
- package/src/ui/render/activity-group.ts +1 -0
- package/src/ui/render/activity-panel.ts +21 -3
- package/src/ui/render/hint.ts +28 -0
- package/src/ui/render/ledger.ts +1 -9
- package/src/ui/render/logo.ts +86 -0
- package/src/ui/render/markdown-table.ts +0 -3
- package/src/ui/render/session-summary.ts +22 -1
- package/src/ui/render/table-grid.ts +0 -3
- package/src/ui/render/theme.ts +36 -5
- package/src/ui/runtime/screen.ts +11 -3
- package/src/ui/screens/dialog.ts +45 -81
- package/src/ui/screens/form.ts +29 -33
- package/src/ui/screens/lifecycle.ts +80 -0
- package/src/ui/screens/model-manager.ts +84 -91
- package/src/ui/screens/picker.ts +36 -33
- package/src/ui/screens/provider-manager.ts +50 -59
- package/src/ui/screens/watchdog.ts +27 -0
- package/src/ui/screens/wizard.ts +3 -20
- package/src/ui/tui/app.ts +97 -11
- package/src/ui/tui/transcript.ts +55 -16
- package/vendor/minicore/src/core/compact.ts +10 -0
- package/vendor/minicore/src/core/errors.ts +11 -1
- package/vendor/minicore/src/core/executor.ts +6 -1
- package/vendor/minicore/src/core/loop.ts +92 -2
- package/vendor/minicore/src/core/session.ts +8 -0
- package/vendor/minicore/src/providers/openai-compat.ts +15 -2
- package/docs/P14_OPEN_WORK.md +0 -290
- package/docs/config-providers.md +0 -87
- package/docs/glossary.md +0 -39
- package/docs/quickstart.md +0 -60
- package/docs/security-model.md +0 -96
- package/docs/terminal.md +0 -91
|
@@ -1,4 +1,55 @@
|
|
|
1
|
-
# Kontrak Terminal MiniCode (TUI fullscreen — v7.
|
|
1
|
+
# Kontrak Terminal MiniCode (TUI fullscreen — v7.14, 2026-11-14)
|
|
2
|
+
|
|
3
|
+
Perubahan v7.14: **geometri & dekorasi popup diseragamkan** (audit Surface
|
|
4
|
+
Popup, `AUD-001..AUD-011`). Empat perubahan tampak-pengguna:
|
|
5
|
+
|
|
6
|
+
1. **Lebar kotak popup diskalakan, bukan angka tetap.** `popupBoxWidth(cols) =
|
|
7
|
+
min(max(40, min(88, floor(cols*0.6))), cols-4)` — dihitung saat *mount* lalu
|
|
8
|
+
**dibekukan** (min=max) agar geometri stabil, tetapi menyesuaikan terminal
|
|
9
|
+
tiap mount. I20 diperbarui. Margin 4 kolom **selalu menang** atas lantai
|
|
10
|
+
40 (AUD-011).
|
|
11
|
+
2. **Sudut kotak MELENGKUNG (`╭ ╮ ╰ ╯`) default.** Kill-switch:
|
|
12
|
+
`MINICODE_BOX=square` (`┌┐└┘`), `MINICODE_BOX=ascii`/`MINICODE_ASCII=1`
|
|
13
|
+
(`+-|`). Dibaca lazy tiap render.
|
|
14
|
+
3. **Backdrop popup = scrim tiga tingkat** (`scrimMode()`):
|
|
15
|
+
`bg` = dim **+ latar `48;5;236`** (≥256 warna), `faint` = `\x1b[2m` saja
|
|
16
|
+
(16 warna), `none` = nol byte (mono/non-TTY/`TERM=dumb`). Reset SGR
|
|
17
|
+
dalam konten **memulihkan** scrim; bold **dinetralkan** ke scrim.
|
|
18
|
+
4. **Kotak approval memakai lebar popup seragam**, bukan selebar layar
|
|
19
|
+
(AUD-007). Opsinya **navigasi daftar**: `↑↓`/`Home`/`End` + `Enter`,
|
|
20
|
+
`Esc` = deny. Ketik-cepat `y`/`a`/`n` (+ sinonim `ya`/`selalu`/`s`/`tidak`/
|
|
21
|
+
`t`) tetap berfungsi — I25 menuntut navigasi daftar, bukan dua langkah wajib.
|
|
22
|
+
|
|
23
|
+
`MINICODE_SCRIM=none` memaksa `faint` untuk diagnostik. Level warna juga
|
|
24
|
+
memakai `process.stdout.getColorDepth()` sesudah env (`COLORTERM`/`TERM`) agar
|
|
25
|
+
Windows Terminal/ConPTY yang tak mengisi `TERM` tetap dapat 256 warna/truecolor
|
|
26
|
+
(AUD-002). Non-TTY **tidak berubah**: 0 warna, 0 scrim, 0 byte (I6).
|
|
27
|
+
|
|
28
|
+
Peta proteksi baru: `test/surface-audit-regressions.test.ts` (AUD-007/008/010/011),
|
|
29
|
+
`test/dialog.test.ts` (glyph melengkung + kill-switch + geometri skala),
|
|
30
|
+
`test/tui-geometry.test.ts` (lebar beku per mount, bukan 64 tetap),
|
|
31
|
+
`test/ui-audit-regressions.test.ts` (AUD-003: bold dinetralkan, `[22m`
|
|
32
|
+
memulihkan scrim — diuji dengan TTY palsu agar `scrimMode() != none`).
|
|
33
|
+
|
|
34
|
+
Perubahan v7.13: baris status kompaksi (`context:compacted`) kini **membedakan
|
|
35
|
+
hasil** alih-alih mencetak `reason` mentah. Sebelumnya sesi yang konteksnya TIDAK
|
|
36
|
+
menyusut tampil sebagai `… dipadatkan: pressure:critical:no-op` — terbaca seolah
|
|
37
|
+
berhasil, padahal turn berikutnya tetap kehabisan konteks. Empat kondisi sekarang
|
|
38
|
+
punya label berbeda karena tindak lanjut user berbeda: `… dipadatkan: tidak ada
|
|
39
|
+
yang bisa dibuang (<sebab>) — konteks tidak menyusut` (no-op), `… kompaksi
|
|
40
|
+
berhenti: target tak tercapai meski hanya N pesan tersisa` (fixpoint), `…
|
|
41
|
+
kompaksi mustahil: instruksi tetap + skema tool (N) sudah melebihi ambang M`
|
|
42
|
+
(biaya tetap), dan `… ringkasan LLM gagal (<sebab>), memakai ringkasan
|
|
43
|
+
mekanikal`. Label tetap satu baris redup (`c.muted`) dan tetap melewati
|
|
44
|
+
`sanitizeAnsiLine` sebelum tampil — teks sebab berasal dari error provider/model
|
|
45
|
+
(input tak terpercaya). Sumber: `src/ui/tui/transcript.ts` (`compactedLabel`),
|
|
46
|
+
kunci i18n `ts.compactedNoOp`/`ts.compactedFixpoint`/`ts.compactedImpossible`/
|
|
47
|
+
`ts.compactedLlmFailed`, dan emisi `reason` dari `vendor/minicore/src/core/
|
|
48
|
+
loop.ts`. Peta proteksi: `test/tui-classic.test.ts` (kontrak render transkrip)
|
|
49
|
+
+ `test/compaction-limits.test.ts` (alasan `impossible:`/`fixpoint` yang
|
|
50
|
+
mendarat di event) + `test/control-plane.test.ts` (`llm-failed:` dilaporkan).
|
|
51
|
+
Nol perubahan pada lebar/geometri: label hanya teks lebih panjang pada jalur
|
|
52
|
+
yang sama, tetap dipotong sesuai aturan baris status yang ada.
|
|
2
53
|
|
|
3
54
|
Perubahan v7.12: footer `context` & `metrics` (window %) kini **live per step**
|
|
4
55
|
selama turn berjalan — kernel meng-emit estimasi konteks turn-store via event
|
|
@@ -16,8 +67,10 @@ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
|
|
|
16
67
|
(v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
|
|
17
68
|
|
|
18
69
|
Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
|
|
19
|
-
sebagai **
|
|
20
|
-
saat aktif (mode Auto + restrictBash) dan
|
|
70
|
+
sebagai **titik monokrom** `●` di ujung footer (setelah Permission Mode), kuning
|
|
71
|
+
saat aktif (mode Auto + restrictBash) dan abu saat nonaktif. Saat mode
|
|
72
|
+
`unrestricted` aktif, titik jadi `○` MERAH (terbuka) sebagai penanda satu-satunya.
|
|
73
|
+
Fallback ASCII `[LOCK]`/`[OPEN]` untuk terminal tanpa UTF-8. Sumbu persetujuan
|
|
21
74
|
tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
|
|
22
75
|
sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
|
|
23
76
|
bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
|
|
@@ -37,9 +90,11 @@ command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
|
|
|
37
90
|
model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
|
|
38
91
|
ringkas.
|
|
39
92
|
|
|
40
|
-
Perubahan v7.7: footer
|
|
41
|
-
dan
|
|
42
|
-
|
|
93
|
+
Perubahan v7.7 (diperbarui v0.24): footer menampilkan nilai Work Mode di sisi
|
|
94
|
+
kiri dan nilai Permission Mode di sisi kanan dekat pemakaian konteks. Label
|
|
95
|
+
`Work Mode:`/`Permission Mode:` dihapus agar footer satu baris lebih lega —
|
|
96
|
+
pembeda sumbu tinggal warna (Work Mode semantik, Permission Mode cyan). Nilai
|
|
97
|
+
kedua mode memakai title case; pada terminal sempit nilai dipadatkan sebelum
|
|
43
98
|
mode atau konteks dihilangkan.
|
|
44
99
|
|
|
45
100
|
Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
|
|
@@ -177,11 +232,15 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
177
232
|
fail-closed di non-TTY/`TERM=dumb`. Siklus hidup region: render yang
|
|
178
233
|
menyusut/bergeser membersihkan union lama+baru (tanpa baris hantu); tutup
|
|
179
234
|
menghapus region sendiri sebelum pemilik repaint.
|
|
235
|
+
- `screen.ts` juga pemilik bentuk kursor: DECSCUSR `6 q` (bar tegak stabil)
|
|
236
|
+
dipancarkan saat caret ditampilkan (`paint`/`moveCursor`) — caret tak
|
|
237
|
+
menutupi karakter di bawahnya dan lebih tenang (clean & minimal). Tetap
|
|
238
|
+
TTY-only: non-TTY = 0 cursor control.
|
|
180
239
|
- Isi popup: kotak terpusat (`dialog.ts`: border, judul opsional dalam garis
|
|
181
240
|
atas, TANPA bayangan) di atas konten redup; `dialogBox` untuk komposit,
|
|
182
241
|
`dialogFrame` (backdrop `░` faint) hanya untuk layar yang memiliki buffer
|
|
183
242
|
sendiri.
|
|
184
|
-
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider
|
|
243
|
+
- **Lebar kotak popup TETAP** per permukaan (model 64, picker 64, provider 64,
|
|
185
244
|
form 64 — min=max): geometri stabil, tak bernapas saat filter/error.
|
|
186
245
|
Nama/ID di DEPAN label (truncasi memakan ekor — tanggal/konteks boleh
|
|
187
246
|
hilang, id selamat).
|
|
@@ -213,6 +272,13 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
213
272
|
`Del` + confirm dalam popup, tercatat); navigasi daftar = `↑↓` + `pgup/
|
|
214
273
|
pgdn` + `home/end` di semua popup ber-daftar; hint footer tiap permukaan
|
|
215
274
|
hanya tombol yang benar-benar berlaku di sana.
|
|
275
|
+
- **Hint aksi minimalis** (audit UI/UX 2026-11): satu baris di dasar body
|
|
276
|
+
picker/manager (`src/ui/render/hint.ts`, satu sumber), format `kunci label`
|
|
277
|
+
— kunci lebih terang, label redup, pemisah `·` — tanpa judul dan tanpa
|
|
278
|
+
footer dekoratif di dalam kotak. `/model`: **Enter = pilih model satu
|
|
279
|
+
langkah** (tanpa picker effort); **Tab = ubah thinking effort** terpisah
|
|
280
|
+
(Esc pada picker effort = batal effort, kembali ke daftar — manajer tak
|
|
281
|
+
pernah menutup diri di sana).
|
|
216
282
|
- Approval tool & ask_user: blok pertanyaan + keputusan DICATAT di transkrip
|
|
217
283
|
(jejak audit) dan layar di-repaint sebelum menjawab; input via askLine di
|
|
218
284
|
baris kursor (aman: input App beku saat busy; Esc/Ctrl+C = abort + deny).
|
|
@@ -259,24 +325,26 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
259
325
|
geometri popup, dialog, dan viewport TUI.
|
|
260
326
|
12. Long session tetap readable (cap 5000 baris, tertua dibuang). Proyeksi
|
|
261
327
|
presentasi mempertahankan cap yang sama dan menambahkan satu marker
|
|
262
|
-
`… N baris awal di luar viewport
|
|
328
|
+
`… N baris awal di luar viewport` yang melacak
|
|
263
329
|
jumlah baris yang di-evict; `total()` tetap monotonik. Buffer jawaban
|
|
264
330
|
live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
|
|
265
331
|
layout paint tidak boleh memproyeksikan transcript dua kali.
|
|
266
332
|
|
|
267
|
-
13. Status bar: 1 baris dasar (`✦ 00.00.00
|
|
268
|
-
|
|
333
|
+
13. Status bar: 1 baris dasar (`✦ 00.00.00 Discuss model cwd … context Auto`)
|
|
334
|
+
dari sumber yang sama dengan angka sesi.
|
|
269
335
|
Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
|
|
270
336
|
LIVE turn-store yang di-emit kernel per step (event `provider:extension`
|
|
271
337
|
kind `context-window`, setelah `step:completed`); saat idle kembali ke
|
|
272
338
|
`session.contextTokens` (committed store). Estimator tetap satu sumber —
|
|
273
339
|
hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
|
|
274
340
|
(beku), tak ada duplikasi angka sumber (v7.12).
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
341
|
+
Titik `●` mengikuti Permission Mode di ujung kanan: kuning bila bash
|
|
342
|
+
allow-list aktif (restrictBash + mode `Auto`), abu bila tidak; `○` merah
|
|
343
|
+
= mode `unrestricted` (fallback ASCII `[LOCK]`/`[OPEN]`). Work Mode berada
|
|
344
|
+
di kiri; Permission Mode cyan berada di kanan dekat konteks (label produk
|
|
345
|
+
`Work Mode:`/`Permission Mode:` dihapus pada v0.24 — nilai saja). Bila ada
|
|
346
|
+
job background hidup, badge `◷ N` (jam berputar pelan, `N` = jumlah job)
|
|
347
|
+
tampil di samping spark; fallback ASCII `[BG:N]`. `✦` tetap
|
|
280
348
|
menjadi indikator proses hidup;
|
|
281
349
|
timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
|
|
282
350
|
detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
|
|
@@ -337,9 +405,18 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
337
405
|
berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
|
|
338
406
|
oldest-to-newest) melalui OSC 52.
|
|
339
407
|
19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
|
|
340
|
-
20. Lebar kotak popup
|
|
341
|
-
|
|
342
|
-
|
|
408
|
+
20. Lebar kotak popup **diskalakan dari lebar layar dan DIBEKUKAN saat mount**:
|
|
409
|
+
`popupBoxWidth(cols) = min(max(40, min(88, floor(cols*0.6))), cols-4)`
|
|
410
|
+
(v7.14 — dulu angka tetap 64 untuk model/picker/provider/form). Semua
|
|
411
|
+
permukaan popup (picker, model, provider, form, wizard, **approval**) memakai
|
|
412
|
+
fungsi yang SAMA — tak ada permukaan yang memakai lebar layar penuh seperti
|
|
413
|
+
approval sebelum v7.14 (AUD-007). Nilai dihitung sekali per mount lalu
|
|
414
|
+
dikirim sebagai `minWidth == maxWidth` sehingga kotak tak "bernapas" selama
|
|
415
|
+
popup terbuka, tetapi tiap mount menyesuaikan terminal. Margin 4 kolom
|
|
416
|
+
SELALU menang atas lantai 40 (terminal < 44 kolom tidak overflow, AUD-011).
|
|
417
|
+
Sudut kotak MELENGKUNG `╭ ╮ ╰ ╯` secara default; `MINICODE_BOX=square`
|
|
418
|
+
mengembalikan lancip, `MINICODE_BOX=ascii`/`MINICODE_ASCII=1` ke ASCII.
|
|
419
|
+
Nama/ID di depan label; seleksi murni warna; search selalu tampil.
|
|
343
420
|
21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
|
|
344
421
|
select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
|
|
345
422
|
luar kotak. Esc dua-tahap: tekan-1 KEMBALIKAN nilai bawaan field
|
|
@@ -369,8 +446,10 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
369
446
|
`/help full`, pintasan via `/help keys`).
|
|
370
447
|
25. Keybinding konsisten: Esc dua-tahap (isi tak hilang sekali tekan);
|
|
371
448
|
backspace/delete edit-teks (hapus-data = confirm); navigasi daftar
|
|
372
|
-
(`↑↓`, pgup/pgdn, home/end) di semua popup; hint
|
|
373
|
-
|
|
449
|
+
(`↑↓`, pgup/pgdn, home/end) di semua popup; hint aksi minimalis
|
|
450
|
+
(`kunci label`, kunci terang/label redup) akurat per permukaan;
|
|
451
|
+
kursor diparkir di semua permukaan; Enter `/model` = pilih satu
|
|
452
|
+
langkah, Tab = ubah effort.
|
|
374
453
|
26. i18n dwibahasa: semua string user-visible lewat `t()`; id kunci = en
|
|
375
454
|
(tsc mengawal); fallback kunci hilang → en; prioritas sesi > env >
|
|
376
455
|
state.json > locale OS > en (di OS: `LC_ALL` > `LANG`, string kosong
|
|
@@ -493,22 +572,24 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
493
572
|
ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
|
|
494
573
|
`plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
|
|
495
574
|
PermissionMode AUTO/ASK.
|
|
496
|
-
**Footer:** Work Mode tampil di kiri
|
|
497
|
-
`
|
|
498
|
-
|
|
499
|
-
`Permission Mode
|
|
500
|
-
warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu
|
|
501
|
-
dibedakan.
|
|
502
|
-
|
|
575
|
+
**Footer:** Work Mode tampil di kiri (nilai `Build`/`Plan`/`Discuss`; alias
|
|
576
|
+
internal `EXECUTE` ditampilkan `Build`). Permission Mode tampil di kanan dekat
|
|
577
|
+
token konteks sebagai nilai `Auto`/`Ask`. Label produk `Work Mode:` dan
|
|
578
|
+
`Permission Mode:` dihapus v0.24 — nilai saja, lebih lega. Nilai Work Mode
|
|
579
|
+
memakai warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu
|
|
580
|
+
mudah dibedakan. Titik `●` kuning = bash allow-list aktif, abu = nonaktif,
|
|
581
|
+
`○` merah = unrestricted. Bila ada job background hidup, badge `◷ N` tampil
|
|
582
|
+
di samping spark.
|
|
503
583
|
|
|
504
584
|
## Grammar (ringkas)
|
|
505
585
|
|
|
506
586
|
prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
|
|
507
587
|
berbingkai di atasnya) ·
|
|
508
|
-
status bar `✦ 00.00.00
|
|
588
|
+
status bar `✦ 00.00.00 Discuss model cwd … context Auto ●`
|
|
509
589
|
(timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
|
|
510
590
|
jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
|
|
511
|
-
|
|
591
|
+
`Work Mode:`/`Permission Mode:` dihapus; `●` kuning = bash allow-list aktif,
|
|
592
|
+
abu = tidak, `○` merah = unrestricted; badge `◷ N` bila job background hidup)
|
|
512
593
|
+ satu spacer sebelum footer · ledger tool
|
|
513
594
|
` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
|
|
514
595
|
kegagalan · pesan error TUI = formatter kanonik (`formatError`,
|
|
@@ -626,7 +707,8 @@ panjang).
|
|
|
626
707
|
pola mati dihapus, subset p15..p24 hadir di kedua job.
|
|
627
708
|
|
|
628
709
|
- `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
|
|
629
|
-
anti-hantu).
|
|
710
|
+
anti-hantu) + I13 (App.paintRegion/clearRegion mendelegasikan region modal ke
|
|
711
|
+
screen; clock badge memutar `◷` saat idle lalu berhenti saat quit).
|
|
630
712
|
- `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
|
|
631
713
|
Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
|
|
632
714
|
select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
|
|
@@ -644,8 +726,13 @@ panjang).
|
|
|
644
726
|
`sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
|
|
645
727
|
sekadar di-import tidak menulis byte ke alt-screen.
|
|
646
728
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
647
|
-
stdout-pipe tanpa sink = deny).
|
|
648
|
-
|
|
729
|
+
stdout-pipe tanpa sink = deny) + modal v0.24 (kotak dilukis via
|
|
730
|
+
`paintRegion`, `clearRegion` dipanggil saat selesai, input raw-mode di-echo
|
|
731
|
+
ke kotak, Esc/Ctrl+C = batal fail-closed).
|
|
732
|
+
- `test/background-job-badge.test.ts` — I13 (badge `◷ N` = jumlah job hidup,
|
|
733
|
+
fase berputar dari clock idle, `[BG:n]` fallback ASCII, nol byte saat 0) +
|
|
734
|
+
`onBackgroundJobFinished` emit TEPAT SEKALI per job (error+close tidak dobel).
|
|
735
|
+
- `test/footer-render.test.ts` — I13 (nilai mode title case tanpa label produk, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, titik `●` kuning/abu + `○` merah unrestricted, badge `◷ N`/`[BG:N]`).
|
|
649
736
|
- `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
|
|
650
737
|
kind `context-window` berisi `usedTokens`/`windowTokens` setelah
|
|
651
738
|
`step:completed` — sumber live-occupancy footer; nilai > 0 terbukti).
|
package/docs/architecture.md
CHANGED
|
@@ -126,7 +126,7 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
|
|
|
126
126
|
|
|
127
127
|
Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard vs bar loading) 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. Bar loading startup (`src/ui/runtime/loading-bar.ts`) adalah painter transient jenis kedua: single-line blok `▓░` + persen + label, digambar ulang hanya saat `update(label, percent)` dipanggil, TTY-only (non-TTY = no-op nol byte), label disanitasi. Diagnostik fase startup (identity/writer/resume/recovery/context) didefer saat REPL ke `ctx.startupNotices` dan di-flush ke transcript TUI; non-interaktif tetap mencetak langsung. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `loading-bar`, `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.
|
|
128
128
|
|
|
129
|
-
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
|
|
129
|
+
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 Discuss model cwd … context Auto ●` — nilai mode saja, label produk `Work Mode:`/`Permission Mode:` dihapus v0.24; titik `●` kuning=allow-list aktif, abu=nonaktif, `○` merah=unrestricted, badge `◷ N` bila job background hidup) 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 (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.
|
|
130
130
|
|
|
131
131
|
## Modul kunci
|
|
132
132
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Autonomous Scheduler (eksperimental)
|
|
1
|
+
# Autonomous Scheduler & Open Work (eksperimental)
|
|
2
2
|
|
|
3
3
|
> **Eksperimental.** Opt-in per invokasi, nonaktif secara bawaan, dan dipicu manual.
|
|
4
4
|
> Tidak ada timer latar (no background timer). Tidak ada yang berjalan kecuali Anda memintanya.
|
|
@@ -135,8 +135,289 @@ kebijakannya sempit, bukan permisif.
|
|
|
135
135
|
tertutup.
|
|
136
136
|
- Eksperimental. Antarmukanya bisa berubah.
|
|
137
137
|
|
|
138
|
+
## Open Work lintas sesi
|
|
139
|
+
|
|
140
|
+
```
|
|
141
|
+
minicode openwork ① TEMUKAN (read-only, lintas sesi)
|
|
142
|
+
minicode openwork inventory ①b AUDIT (inventaris P14.0 lintas sumber)
|
|
143
|
+
minicode openwork context --session S --task tN
|
|
144
|
+
①c SUSUN KONTEKS (P14.5, tanpa eksekusi)
|
|
145
|
+
minicode --session <target> \
|
|
146
|
+
--adopt-task <source>/<taskId> "..." ② ADOPSI (eksplisit, otoritas ganda)
|
|
147
|
+
/scheduler run ③ LANJUTKAN (manual, lewat gate continuity)
|
|
148
|
+
(minimum satu turn) ④ KERJAKAN (claim = generasi BARU)
|
|
149
|
+
minicode openwork --closed ⑤ TUTUP (feedback berprovenance)
|
|
150
|
+
minicode openwork export --out FILE ⑤b EKSPOR (json/md, atomik)
|
|
151
|
+
minicode openwork merge ... ⑥ DEDUP (eksplisit + evidence)
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### ① Menemukan: `minicode openwork`
|
|
155
|
+
|
|
156
|
+
Portofolio read-only seluruh task non-terminal di **workspace ini** (tasks.db
|
|
157
|
+
memang per-workspace — sesi proyek lain memang tidak terlihat, itu batas yang
|
|
158
|
+
benar, bukan bug), **ditambah** kandidat intent terstruktur dari histori
|
|
159
|
+
(lihat "Kandidat intent" di bawah).
|
|
160
|
+
|
|
161
|
+
```
|
|
162
|
+
Open Work — 1 item(s) · 1 intent · 1 stale · 0 unknown-provenance
|
|
163
|
+
workspace: D:\proyek · stale after 7d · TaskStore remains the sole status authority
|
|
164
|
+
|
|
165
|
+
p14ow-source/t1 · IN_PROGRESS · PARTIAL · P2 · 2d old
|
|
166
|
+
title: Fix login bug
|
|
167
|
+
flags: STALE · FROM:p14ow-source · SIMILAR×2(UNPROVEN)
|
|
168
|
+
blockers: TASK_BLOCKED: API key rotated
|
|
169
|
+
depends on: t2 (PENDING, unsatisfied)
|
|
170
|
+
next: resume: rebuild context from provenance, then continue via TaskStore/Scheduler
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
Arti bidang:
|
|
174
|
+
|
|
175
|
+
| Bidang | Makna |
|
|
176
|
+
|---|---|
|
|
177
|
+
| `status` | status kanonik TaskStore — **satu-satunya otoritas** |
|
|
178
|
+
| state (kolom ke-4) | state P14.1 berbasis bukti: `OPEN/PARTIAL/BLOCKED/WAITING_FOR_USER/DELEGATED/FAILED_NEEDS_FOLLOWUP/UNKNOWN`; verifikasi gagal → FAILED_NEEDS_FOLLOWUP, dependensi tak tuntas → BLOCKED |
|
|
179
|
+
| `P0..P3` | prioritas presentasi: BLOCKED/FAILED=P0, WAITING/DELEGATED/UNKNOWN=P1, PARTIAL=P2, OPEN=P3; item STALE dinaikkan satu tingkat — umur sinyal, bukan bukti |
|
|
180
|
+
| `blockers:` | blocker eksplisit (TASK_BLOCKED / DEPENDENCY / VERIFICATION); kosong = tidak ada yang diklaim |
|
|
181
|
+
| `depends on:` | dependensi kanonik direkonsiliasi ke status saat baca; hanya COMPLETED yang *satisfied* |
|
|
182
|
+
| `next:` | tindak lanjut eksplisit — selalu lewat jalur otoritas yang ada; openwork TIDAK PERNAH mengeksekusi |
|
|
183
|
+
|
|
184
|
+
Arti penanda:
|
|
185
|
+
|
|
186
|
+
| Penanda | Makna | Tindak lanjut |
|
|
187
|
+
|---|---|---|
|
|
188
|
+
| `STALE` | baris tak bergerak ≥ ambang (default 7 hari, `--stale-days <n>`) | prioritas, bukan keputusan otoritas |
|
|
189
|
+
| `PROVENANCE-UNKNOWN` | tidak ada baris sesi di sessions.db — asal tak bisa ditelusuri | periksa manual; jangan dianggap rusak |
|
|
190
|
+
| `FROM:<sesi>` | task ini DIPINDAHKAN dari sesi lain (ledger `task_transfers`) | provenance asal eksplisit |
|
|
191
|
+
| `SIMILAR×N(UNPROVEN)` | N task berbagi judul ternormalisasi | **bukan bukti duplikat** — lihat ⑥ |
|
|
192
|
+
| `DUP-GROUP×N(UNPROVEN)` | grup duplikat **lintas sesi** (task + intent) beranggota N | lihat seksi "Grup duplikat lintas sesi" |
|
|
193
|
+
|
|
194
|
+
Filter: `--session <id>`, `--status <S>`, `--state <S>`, `--priority <P0..P3>`,
|
|
195
|
+
`--min-age-days <n>`, `--blocked`, `--depends-on <taskId>`, `--closed`,
|
|
196
|
+
`--json` (satu objek JSON mesin di stdout). Exit: `0` sukses (termasuk daftar
|
|
197
|
+
kosong), `1` gagal runtime/lookup, `2` salah pakai (nilai enum tak dikenal
|
|
198
|
+
termasuk).
|
|
199
|
+
|
|
200
|
+
**Batas kejujuran:** `openwork` tidak pernah menulis apa pun — tidak
|
|
201
|
+
mengakuisisi lease, tidak membuat sessions.db, tidak menulis backup manifest
|
|
202
|
+
korup, tidak memicu scheduler. Ia indeks, bukan otoritas. (Dijaga guard
|
|
203
|
+
arsitektur + tes nol-mutasi, kini termasuk jalur inventaris.)
|
|
204
|
+
|
|
205
|
+
### Kandidat intent: histori terstruktur, TANPA menebak prosa
|
|
206
|
+
|
|
207
|
+
Portofolio juga menampilkan **kandidat intent open** dari histori yang
|
|
208
|
+
terstruktur dan durable:
|
|
209
|
+
|
|
210
|
+
| Sumber | Kapan jadi kandidat | State |
|
|
211
|
+
|---|---|---|
|
|
212
|
+
| `plan.updated` | langkah plan `pending`/`active`/`blocked` **tanpa** task kanonik (atau baris task-nya hilang) | OPEN / PARTIAL / BLOCKED |
|
|
213
|
+
| `approval.requested` | belum ada `approval.settled` | WAITING_FOR_USER |
|
|
214
|
+
| sesi anak sub-agent | belum ada hasil terminal | DELEGATED |
|
|
215
|
+
| sesi anak + `turn.failed` | delegasi gagal | FAILED_NEEDS_FOLLOWUP |
|
|
216
|
+
| run `INTERRUPTED` | eksekusi terputus (restart/kill) | FAILED_NEEDS_FOLLOWUP |
|
|
217
|
+
|
|
218
|
+
Yang SENGAJA tidak dilakukan: memindai isi pesan bebas pengguna. Janji dari
|
|
219
|
+
prosa ("nanti kita perbaiki login") TIDAK PERNAH menjadi tugas — roadmap P14
|
|
220
|
+
melarang menganggap brainstorming sebagai task, dan menentukan kapan intent
|
|
221
|
+
prosa jadi komitmen adalah keputusan produk yang belum diputuskan pemilik.
|
|
222
|
+
|
|
223
|
+
Aturan kejujuran ekstraksi (dijaga tes):
|
|
224
|
+
|
|
225
|
+
1. Langkah plan yang menunjuk task kanonik yang masih OPEN **menempel sebagai
|
|
226
|
+
bukti** di entri task (`plan evidence`), bukan item duplikat.
|
|
227
|
+
2. Langkah plan yang mengaku `active` atas task yang SUDAH terminal tidak
|
|
228
|
+
dihidupkan kembali — masuk closure dengan alasan "canonical task
|
|
229
|
+
<status> supersedes plan claim", konflik diungkap, bukan disembunyikan.
|
|
230
|
+
3. Approval yang di-**allow** bukan bukti pekerjaan selesai — tidak
|
|
231
|
+
menghasilkan kandidat apa pun (hanya deny yang menghasilkan DECLINED).
|
|
232
|
+
4. Run `RUNNING` bukan open loop — runtime hidup adalah kondisi normal.
|
|
233
|
+
5. Cakupan pencarian dibatasi binding `cwd` baris sesi; **sesi anak mewarisi
|
|
234
|
+
cakupan leluhur termulaiannya** (hasil sub-agent tetap terlihat); sesi
|
|
235
|
+
tanpa binding dilabel UNBOUND dan dikeluarkan — tidak ada yang ditebak.
|
|
236
|
+
6. `plan.updated` adalah **snapshot**, bukan delta: adaptor menerbitkannya setiap
|
|
237
|
+
`todo_write` sukses dengan SELURUH daftar langkah. Hanya snapshot TERAKHIR
|
|
238
|
+
per **sesi** yang dibaca (bukan per `planId` — `planId` memuat nomor turn,
|
|
239
|
+
sedangkan daftar todo milik sesi). Akibatnya: versi pending/active lama tidak
|
|
240
|
+
muncul sebagai open loop kedua, langkah yang dihapus dari daftar tidak
|
|
241
|
+
dihidupkan, dan langkah yang masih terbuka tidak berganda di setiap turn.
|
|
242
|
+
|
|
243
|
+
### Grup duplikat lintas sesi (P14.3 penuh)
|
|
244
|
+
|
|
245
|
+
Kandidat dengan judul ternormalisasi sama **lintas sesi** (termasuk task vs
|
|
246
|
+
langkah plan) dikelompokkan dan diungkapkan:
|
|
247
|
+
|
|
248
|
+
```
|
|
249
|
+
Similar groups — 1 (UNPROVEN, never auto-merged)
|
|
250
|
+
"fix login bug" ×2 across 2 session(s) · DIVERGENT states
|
|
251
|
+
sessions: p14fs-a · p14fs-b
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
Grup dengan state yang saling bertentangan ditandai `DIVERGENT` (jumlahnya
|
|
255
|
+
juga di header + `counts.conflicts`). Grup **tidak pernah** menyatukkan apa
|
|
256
|
+
pun: perpindahan otoritas tetap wajib adopsi eksplisit (②), merge tetap
|
|
257
|
+
satu-sesi (⑥). Tugas berulang yang sengaja independen boleh berbagi grup —
|
|
258
|
+
itu penanda untuk diperiksa, bukan vonis.
|
|
259
|
+
|
|
260
|
+
### ①b Inventaris: `minicode openwork inventory [--json]`
|
|
261
|
+
|
|
262
|
+
Inventaris P14.0 lintas sumber, read-only: jumlah sesi (in-scope / foreign /
|
|
263
|
+
unbound / anak), task (total/open/terminal), event presentasi per tipe, run,
|
|
264
|
+
manifest checkpoint (termasuk yang **corrupt** — dilabel, tidak dibackup oleh
|
|
265
|
+
proyeksi), langkah plan, approval, dan hasil sub-agent. Sesi yang dikeluarkan
|
|
266
|
+
dicantumkan **dengan alasannya**. Event yang gagal didekode dilaporkan sebagai
|
|
267
|
+
"unreadable", tidak disembunyikan.
|
|
268
|
+
|
|
269
|
+
### ①c Konteks: `minicode openwork context --session <id> --task <taskId>`
|
|
270
|
+
|
|
271
|
+
Context pack P14.5 untuk satu task: field kanonik (status/revisi/verification/
|
|
272
|
+
dependsOn/evidence), state + prioritas + blocker + next action, bukti langkah
|
|
273
|
+
plan, ketersediaan checkpoint (termasuk corrupt), provenance transfer/merge,
|
|
274
|
+
freshness, dan **checklist resume**. Pack ini murni baca — checklist menunjuk
|
|
275
|
+
jalur yang MEMAKSAK otoritas saat resume (ceiling P12, gate continuity P13.3,
|
|
276
|
+
claim generation TaskStore, budget/cancellation P12/P13); openwork sendiri
|
|
277
|
+
tidak memeriksa apalagi mengeksekusi. Exit `1` bila task tak ditemukan,
|
|
278
|
+
`2` bila id cacat.
|
|
279
|
+
|
|
280
|
+
### ② Mengadopsi: `--adopt-task <source>/<taskId>`
|
|
281
|
+
|
|
282
|
+
Satu task per invokasi, HANYA saat startup sesi tujuan, sebelum turn pertama:
|
|
283
|
+
|
|
284
|
+
```
|
|
285
|
+
minicode --session target --adopt-task p14ow-source/t1 "lanjutkan pekerjaan ini"
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
Yang terjadi (satu transaksi TaskStore, dicek ulang di dalam transaksi):
|
|
289
|
+
inkarnasi sumber+tujuan, revisi, **kedua lease** (token sumber dan tujuan),
|
|
290
|
+
status non-terminal, konsistensi lineage, tabrakan id target, dan provenance
|
|
291
|
+
relasi. Penulis sesi sumber yang **hidup** = `REFUSED_SOURCE_BUSY` (tidak ada
|
|
292
|
+
takeover paksa). Lease sumber kedaluwarsa = takeover + **fence epoch** —
|
|
293
|
+
proses lama tidak bisa lagi renew/release/menulis/menjadwalkan sesi sumber.
|
|
294
|
+
|
|
295
|
+
Yang TIDAK terjadi: tidak menyalin task, tidak membuat generasi baru, tidak
|
|
296
|
+
menandai selesai, tidak menyentuh jurnal runtime/child run/approval, dan
|
|
297
|
+
**tidak memicu scheduler**. Task in-flight hasil adopsi tetap `IN_PROGRESS`
|
|
298
|
+
dengan lineage asli — apakah boleh dilanjutkan adalah keputusan gate (③),
|
|
299
|
+
bukan adopsi.
|
|
300
|
+
|
|
301
|
+
Rantai relasi diadopsi **berurutan** (parent/dependency dulu, lalu anak);
|
|
302
|
+
penolakan menamai id yang belum diadopsi. Id task tidak pernah direnumber.
|
|
303
|
+
|
|
304
|
+
### ③ Melanjutkan: `/scheduler run` (manual, tersupervisi)
|
|
305
|
+
|
|
306
|
+
Adopsi tidak menyalakan scheduler. Lanjutan tetap lewat trigger manual yang
|
|
307
|
+
sudah ada (`/scheduler run` di sesi TUJUAN; butuh `--enable-scheduler` saat
|
|
308
|
+
memulai sesi CLI, sedangkan sesi daemon hosted mendapatkannya via
|
|
309
|
+
`--runtime owned`). Reconcilasi menilai task in-flight hasil
|
|
310
|
+
adopsi lewat **continuity gate P13.3** — kontraknya tidak berubah:
|
|
311
|
+
|
|
312
|
+
- `SAFE_TO_RETRY` (bukti resume + admission + **seluruh** scope tool otonom
|
|
313
|
+
read-only) → revert ke PENDING → **claim generasi BARU** → dispatch serial.
|
|
314
|
+
- Selain itu → `HOLD` / `REQUIRES_VERIFIER`, baris tidak disentuh, nol
|
|
315
|
+
dispatch. Tanpa gate = HOLD (fail-closed).
|
|
316
|
+
|
|
317
|
+
**Tidak pernah ada replay instruksi tool jurnal lama** — work item hanya
|
|
318
|
+
membawa `(taskId, title, instruction, sessionId)`; eksekusi baru lahir dari
|
|
319
|
+
claim baru. Permission ceiling P12, budget, cancellation, dan stop criteria
|
|
320
|
+
P13 tetap berlaku persis seperti sesi biasa.
|
|
321
|
+
|
|
322
|
+
### ④ Menutup: lifecycle biasa
|
|
323
|
+
|
|
324
|
+
Selesaian lewat jalur kanonik yang sudah ada (verifier / `todo_write` /
|
|
325
|
+
operator) — P14 tidak punya jalur penutupan sendiri dan tidak pernah
|
|
326
|
+
menulis `COMPLETED` atas nama operator.
|
|
327
|
+
|
|
328
|
+
### ⑤ Feedback penutupan: `minicode openwork --closed`
|
|
329
|
+
|
|
330
|
+
Closure feedback adalah **pembacaan ulang status kanonik + ledger**, bukan
|
|
331
|
+
kesimpulan: task yang sudah terminal dan punya provenance P14 (transfer
|
|
332
|
+
atau merge) muncul dengan `status`, `closed`, `FROM <sesi>`,
|
|
333
|
+
`duplicate-of <task>`, dan evidence operator. Duplikat yang dibuka kembali
|
|
334
|
+
operator otomatis muncul lagi di seksi open — status saat itulah kebenaran.
|
|
335
|
+
|
|
336
|
+
Sejak pengiriman full-scope, closure juga mencakup **artefak intent terminal**
|
|
337
|
+
(`kind INTENT`) dengan **label klaim** yang wajib dibaca:
|
|
338
|
+
|
|
339
|
+
| `claim` | Arti |
|
|
340
|
+
|---|---|
|
|
341
|
+
| `verified` | task kanonik terminal dengan `verification.verdict = passed` |
|
|
342
|
+
| `unverified` | klaim penyelesaian oleh artefak (mis. plan step `completed`) **tanpa** verifikasi — ditampilkan apa adanya, BUKAN disembunyikan, BUKAN dianggap terbukti |
|
|
343
|
+
| `not-applicable` | DECLINED/CANCELLED — tidak ada klaim penyelesaian untuk diverifikasi |
|
|
344
|
+
|
|
345
|
+
Termasuk: approval yang ditolak pengguna → `DECLINED` (terminal, tidak pernah
|
|
346
|
+
hidup lagi sebagai open loop), dan langkah plan yang mengaku `active` atas task
|
|
347
|
+
terminal → closure dengan alasan "canonical task `<status>` supersedes plan
|
|
348
|
+
claim" — konflik klaim diungkap, tidak ditelan.
|
|
349
|
+
|
|
350
|
+
### ⑤b Ekspor: `minicode openwork export --out <path> [--format json|md] [--force]`
|
|
351
|
+
|
|
352
|
+
- `json` (default) — objek portofolio lengkap (selalu menyertakan inventaris
|
|
353
|
+
P14.0), indentasi 2 spasi.
|
|
354
|
+
- `md` — laporan manusia tersanitasi (judul/evidence bebas sekuens ANSI).
|
|
355
|
+
- Ditulis **atomik** (`atomicWriteText`); **menolak menimpa** berkas yang ada
|
|
356
|
+
kecuali `--force`; kegagalan tulis = exit `1` tanpa berkas sampah `.tmp.*`.
|
|
357
|
+
|
|
358
|
+
### ⑥ Dedup eksplisit: `openwork merge`
|
|
359
|
+
|
|
360
|
+
```
|
|
361
|
+
minicode openwork merge --session target --keep t1 --drop t2 \
|
|
362
|
+
--evidence "satu unit kerja yang sama: sama-sama memperbaiki login bug"
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
Aturan (dijaga tes + guard):
|
|
366
|
+
|
|
367
|
+
1. **Evidence WAJIB** dan direkam utuh di ledger append-only `task_merges`.
|
|
368
|
+
Kemiripan judul TIDAK PERNAH menjadi bukti; `SIMILAR×N(UNPROVEN)` hanyalah
|
|
369
|
+
penanda. Tidak ada merge otomatis dari proyeksi.
|
|
370
|
+
2. Duplikat ditutup **`CANCELLED`, bukan `COMPLETED`** — menyatakan "dikerjakan
|
|
371
|
+
di task lain" tidak boleh meng-inferr penyelesaian.
|
|
372
|
+
3. Penulisan status lewat `patchTask` (lifecycle biasa: revisi maju, ownership
|
|
373
|
+
in-flight dilepas) + INSERT ledger dalam **SATU transaksi** — gagal ledger =
|
|
374
|
+
status ikut rollback.
|
|
375
|
+
4. Duplikat terminal ditolak (pekerjaan tertutup tidak dibuka untuk ditutup
|
|
376
|
+
lagi). Survivor terminal BOLEH (kasus klasik: pending ternyata sudah
|
|
377
|
+
dikerjakan task yang selesai — duplikat tetap CANCELLED).
|
|
378
|
+
5. **Antar-sesi ditolak**: merge hanya satu namespace. Duplikat lintas sesi
|
|
379
|
+
harus diadopsi dulu (②), lalu merge di sesi tujuan.
|
|
380
|
+
6. Pembalikan = penulisan lifecycle biasa (patch status kembali). Ledger
|
|
381
|
+
append-only tetap mencatat deklarasi — audit sejarah, status = kebenaran.
|
|
382
|
+
|
|
383
|
+
### Peta bukti
|
|
384
|
+
|
|
385
|
+
| Klaim | Bukti |
|
|
386
|
+
|---|---|
|
|
387
|
+
| Proyeksi read-only (nol mutasi) | `test/p14-open-work.test.ts` (proyeksi nol-mutasi) |
|
|
388
|
+
| Nol mutasi jalur PENUH (histori + inventaris ikut diuji; tanpa backup manifest korup) | `test/p14-full-scope.test.ts` (zero-mutasi proyeksi penuh) |
|
|
389
|
+
| UNKNOWN/stale dilabel jujur | `test/p14-open-work.test.ts` (provenance UNKNOWN tanpa membuat sessions.db; STALE ambang disuntik) |
|
|
390
|
+
| Kemiripan bukan identitas | idem (SIMILAR UNPROVEN, ambiguous tetap terpisah) |
|
|
391
|
+
| Grup duplikat LINTAS SESI + konflik divergent, tanpa merge otomatis | `test/p14-full-scope.test.ts` (P14.3 grup lintas sesi) |
|
|
392
|
+
| Kontrak P14.1: state/prioritas/next action murni + fail-closed | idem (P14.1 kontrak murni) |
|
|
393
|
+
| Ekstraksi intent: approval allow ≠ COMPLETED; pesan bebas tak dipindai; cakupan lineage | idem (P14.2 extractIntentCandidates) |
|
|
394
|
+
| Klaim plan atas task terminal: tak dihidupkan, konflik diungkap, label claim verified/unverified | idem (P14.2 proyeksi histori) |
|
|
395
|
+
| Inventaris P14.0 lintas sumber + sesi dikeluarkan dengan alasan | idem (P14.0 inventaris) |
|
|
396
|
+
| Matriks forensik: restart/terputus/pembatalan/stale | idem (P14.6 matriks forensik) |
|
|
397
|
+
| Portofolio: blocker/dependensi/verifikasi/next action | idem (P14.4 bidang portofolio) |
|
|
398
|
+
| CLI: filter baru, inventory, context, export atomik + sanitasi | idem (CLI full-scope; exit 0/1/2 sesuai I28) |
|
|
399
|
+
| Merge aman/auditable/atomic | `test/p14-open-work.test.ts` (DECLARED/refusal/terminal/stale/atomic-rollback/pembalikan) |
|
|
400
|
+
| Alur ①→⑤ utuh, generasi baru, tanpa replay | idem (P14.5 alur operator) |
|
|
401
|
+
| Adopsi: otoritas ganda, fence, ledger transfer | `test/p14-cross-session-adoption.test.ts` (14 skenario) |
|
|
402
|
+
| Guard "bukan TaskStore/scheduler kedua" + proyeksi murni | `test/p2-architecture-guards.test.ts` |
|
|
403
|
+
| Kontrak penulis CLI (OAP-008) | `test/writer-inventory.test.ts` (deklarasi per writer) |
|
|
404
|
+
| Snapshot `plan.updated` dikolaps per sesi (tanpa duplikasi riwayat) | `test/p14-full-scope.test.ts` (5 tes snapshot plan) |
|
|
405
|
+
|
|
406
|
+
### Batas scope yang TIDAK diklaim
|
|
407
|
+
|
|
408
|
+
Dokumen ini sengaja tidak menjanjikan hal-hal berikut; semuanya eksklusi
|
|
409
|
+
scope P14 yang disetujui pemilik 2026-10-26, bukan pekerjaan tertunda:
|
|
410
|
+
|
|
411
|
+
| Tidak ada | Alasan |
|
|
412
|
+
|---|---|
|
|
413
|
+
| Ekstraksi intent dari prosa bebas | Dilarang eksplisit oleh roadmap ("jangan anggap setiap pesan brainstorming sebagai tugas") |
|
|
414
|
+
| Readout TUI `/openwork` | Teks milestone hanya "tampilkan/ekspor"; permukaan TUI baru butuh kontrak terminal sendiri |
|
|
415
|
+
| Merge dengan lease/admission | Di luar teks milestone; merge tetap satu transaksi + ledger audit |
|
|
416
|
+
| Merge lintas sesi tanpa adopsi eksplisit | Model otoritas roadmap: portfolio = projection, perubahan task lewat jalur authority |
|
|
417
|
+
| Klaim release-ready | Closure P14 hanya untuk kontrak bukti-terstruktur; limitasi P13 tetap berlaku dan tree masih uncommitted |
|
|
418
|
+
|
|
138
419
|
## Terkait
|
|
139
420
|
|
|
140
421
|
- [CLI](cli.md) — referensi lengkap flag.
|
|
141
422
|
- [Arsitektur](architecture.md) — di mana scheduler berada.
|
|
142
|
-
- [Open Work](
|
|
423
|
+
- [Open Work](autonomous-scheduler.md) — pekerjaan lintas sesi yang diteruskan scheduler.
|
package/docs/choosing-mode.md
CHANGED
|
@@ -6,7 +6,7 @@ Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
|
|
|
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 — **kecuali mode `unrestricted
|
|
9
|
+
Hard security (path jail luar workspace, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya — **kecuali mode `unrestricted`**, yang membuka jail path luar workspace + bash-guard + allowlist, tetapi file sensitif (`.env`, `.ssh`) dan state milik minicode (`.minicode/`) tetap ditolak (lihat baris terakhir tabel).
|
|
10
10
|
|
|
11
11
|
## Kalau tujuan Anda X → gunakan Y
|
|
12
12
|
|
|
@@ -18,7 +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
|
|
21
|
+
| Full akses tanpa pembatas (VM/VPN tepercaya) | `/unrestric` (perintah TUI tersembunyi, per-sesi) | Melepas jail path luar workspace + bash-guard + allowlist/sandbox; kredensial git sempit (`GH_TOKEN`/`GITHUB_TOKEN`/`SSH_AUTH_SOCK`) diteruskan hanya di mode ini; file sensitif dan state minicode tetap ditolak; footer menampilkan `○` merah |
|
|
22
22
|
|
|
23
23
|
## Rule of thumb
|
|
24
24
|
|
|
@@ -27,7 +27,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
27
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.
|
|
28
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.
|
|
29
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** —
|
|
30
|
+
6. **`/unrestric` hanya untuk lingkungan yang benar-benar Anda percaya** — model bisa menyentuh file apa pun di host (kecuali file sensitif/state minicode), menjalankan shell tanpa allow-list, dan `git_push` ke remote. Sering kali `BUILD`+`AUTO`+sandbox sudah cukup.
|
|
31
31
|
|
|
32
32
|
## Tradeoff yang jujur
|
|
33
33
|
|
|
@@ -37,7 +37,7 @@ Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlak
|
|
|
37
37
|
|
|
38
38
|
## Lanjut
|
|
39
39
|
|
|
40
|
-
- [
|
|
40
|
+
- [Keamanan](security.md) — apa yang ditegakkan tiap mode.
|
|
41
41
|
- [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
|
|
42
42
|
- [Otomasi & CI](exec.md) — batasan headless.
|
|
43
43
|
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|