minicode-ai 0.11.0 → 0.13.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.
Files changed (221) hide show
  1. package/CHANGELOG.md +98 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -4
  4. package/cli/args.ts +46 -0
  5. package/cli/commands/acp.ts +163 -10
  6. package/cli/commands/config.ts +33 -18
  7. package/cli/commands/daemon.ts +515 -0
  8. package/cli/commands/exec.ts +145 -53
  9. package/cli/commands/openwork.ts +986 -0
  10. package/cli/commands/sessions.ts +4 -1
  11. package/cli/commands/stats.ts +34 -4
  12. package/cli/commands.ts +217 -2
  13. package/cli/index.ts +146 -14
  14. package/cli/recovery-warning.ts +115 -0
  15. package/cli/router.ts +32 -1
  16. package/cli/setup.ts +2332 -171
  17. package/cli/tui.ts +113 -7
  18. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +489 -0
  19. package/docs/OUTPUT_EVENT_MODEL.md +289 -0
  20. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +391 -0
  21. package/docs/OUTPUT_PROTOCOL_SPEC.md +285 -0
  22. package/docs/OUTPUT_RENDERING_SPEC.md +248 -0
  23. package/docs/OUTPUT_UX_RULES.md +449 -0
  24. package/docs/PLAN_UIUX_V6.md +2 -2
  25. package/docs/README.md +4 -3
  26. package/docs/TERMINAL_CONTRACT.md +278 -66
  27. package/docs/architecture.md +89 -7
  28. package/docs/changelog.md +1 -1
  29. package/docs/choosing-mode.md +2 -2
  30. package/docs/cli.md +9 -5
  31. package/docs/concepts.md +1 -1
  32. package/docs/contributing.md +9 -2
  33. package/docs/environment.md +6 -2
  34. package/docs/exec.md +46 -5
  35. package/docs/memory-sessions.md +2 -0
  36. package/docs/policy-sandbox.md +1 -1
  37. package/docs/pricing-budget.md +1 -1
  38. package/docs/quickstart.md +2 -2
  39. package/docs/repl.md +6 -2
  40. package/docs/security-model.md +1 -1
  41. package/docs/security.md +1 -1
  42. package/docs/skills.md +2 -2
  43. package/docs/terminal.md +9 -5
  44. package/docs/tools.md +1 -1
  45. package/package.json +35 -5
  46. package/src/app/session.ts +261 -15
  47. package/src/app/tool-layer.ts +94 -7
  48. package/src/daemon/approvals.ts +361 -0
  49. package/src/daemon/capability.ts +145 -0
  50. package/src/daemon/children.ts +142 -0
  51. package/src/daemon/client.ts +267 -0
  52. package/src/daemon/control.ts +350 -0
  53. package/src/daemon/discovery.ts +234 -0
  54. package/src/daemon/feed.ts +155 -0
  55. package/src/daemon/framing.ts +94 -0
  56. package/src/daemon/host.ts +316 -0
  57. package/src/daemon/protocol.ts +217 -0
  58. package/src/daemon/resource.ts +170 -0
  59. package/src/daemon/sanitize.ts +57 -0
  60. package/src/daemon/server.ts +627 -0
  61. package/src/daemon/store.ts +317 -0
  62. package/src/daemon/subscription.ts +270 -0
  63. package/src/daemon/telemetry.ts +81 -0
  64. package/src/hooks/run.ts +12 -1
  65. package/src/lib/atomic-write.ts +29 -3
  66. package/src/lib/db-path.ts +26 -0
  67. package/src/lib/keystore.ts +544 -42
  68. package/src/lib/net.ts +43 -1
  69. package/src/lib/safe-open.ts +116 -1
  70. package/src/lib/session-id.ts +15 -0
  71. package/src/lsp/client.ts +123 -5
  72. package/src/mcp/client.ts +139 -17
  73. package/src/mcp/server.ts +177 -50
  74. package/src/mcp/transport.ts +16 -19
  75. package/src/memory/vector.ts +770 -55
  76. package/src/policy/allowlist.ts +14 -2
  77. package/src/policy/bash-guard.ts +105 -10
  78. package/src/policy/compaction.ts +82 -5
  79. package/src/policy/consequence-engine.ts +220 -0
  80. package/src/policy/context.ts +132 -0
  81. package/src/policy/executor.ts +187 -121
  82. package/src/policy/no-progress.ts +559 -0
  83. package/src/policy/permission.ts +4 -8
  84. package/src/policy/pricing.ts +17 -3
  85. package/src/policy/scrub.ts +69 -2
  86. package/src/policy/tool-contract.ts +515 -0
  87. package/src/policy/usage.ts +310 -24
  88. package/src/policy/verifier.ts +6 -3
  89. package/src/policy/work-mode.ts +182 -0
  90. package/src/presentation/adapter.ts +533 -26
  91. package/src/presentation/events.ts +151 -0
  92. package/src/presentation/model.ts +180 -27
  93. package/src/presentation/projection.ts +858 -0
  94. package/src/presentation/reducer.ts +645 -310
  95. package/src/presentation/store.ts +12 -7
  96. package/src/providers/anthropic.ts +18 -10
  97. package/src/providers/responses.ts +17 -7
  98. package/src/runtime/capability.ts +409 -0
  99. package/src/runtime/child-execution.ts +274 -0
  100. package/src/runtime/composition.ts +958 -0
  101. package/src/runtime/dispatch.ts +591 -0
  102. package/src/runtime/execution-backend.ts +632 -0
  103. package/src/runtime/execution-events.ts +272 -0
  104. package/src/runtime/execution-id.ts +230 -0
  105. package/src/runtime/execution-journal.ts +926 -0
  106. package/src/runtime/execution-kernel.ts +456 -0
  107. package/src/runtime/execution-registry.ts +379 -0
  108. package/src/runtime/process-supervision.ts +276 -0
  109. package/src/runtime/production-execution.ts +551 -0
  110. package/src/runtime/production-runtime.ts +217 -0
  111. package/src/runtime/recovery-safety.ts +70 -0
  112. package/src/runtime/recovery.ts +477 -0
  113. package/src/runtime/runtime-capabilities.ts +179 -0
  114. package/src/runtime/runtime-diagnostics.ts +141 -0
  115. package/src/runtime/runtime-host.ts +365 -0
  116. package/src/runtime/runtime-status-facts.ts +222 -0
  117. package/src/runtime/runtime-status-provider.ts +74 -0
  118. package/src/runtime/runtime-status.ts +459 -0
  119. package/src/runtime/runtime-task-admission.ts +101 -0
  120. package/src/runtime/supervisor.ts +444 -0
  121. package/src/session/authority.ts +168 -0
  122. package/src/session/checkpoint.ts +88 -1
  123. package/src/session/context-adapter.ts +251 -0
  124. package/src/session/context-assembly.ts +242 -0
  125. package/src/session/context-identity.ts +389 -0
  126. package/src/session/context-projection.ts +248 -0
  127. package/src/session/context-selector.ts +500 -0
  128. package/src/session/cross-session-adoption.ts +249 -0
  129. package/src/session/full-history-fold.ts +171 -0
  130. package/src/session/identity.ts +192 -0
  131. package/src/session/journal.ts +805 -102
  132. package/src/session/open-work-intent.ts +732 -0
  133. package/src/session/open-work.ts +767 -0
  134. package/src/session/pending-tools.ts +94 -0
  135. package/src/session/persistence.ts +3569 -127
  136. package/src/session/runtime-header.ts +208 -0
  137. package/src/session/shadow-git.ts +13 -5
  138. package/src/session/verification.ts +1623 -0
  139. package/src/task/assignment.ts +136 -0
  140. package/src/task/autonomous-adapter.ts +168 -0
  141. package/src/task/autonomous-context.ts +630 -0
  142. package/src/task/autonomous-policy.ts +490 -0
  143. package/src/task/continuity.ts +179 -0
  144. package/src/task/execution-cancellation.ts +165 -0
  145. package/src/task/graph-validate.ts +379 -0
  146. package/src/task/graph.ts +305 -0
  147. package/src/task/identity.ts +230 -0
  148. package/src/task/model.ts +417 -0
  149. package/src/task/production-scheduler.ts +293 -0
  150. package/src/task/readiness.ts +229 -0
  151. package/src/task/scheduler-observability.ts +387 -0
  152. package/src/task/scheduler.ts +1197 -0
  153. package/src/task/scheduling-policy.ts +165 -0
  154. package/src/task/session-authority.ts +148 -0
  155. package/src/task/session-ownership.ts +211 -0
  156. package/src/task/store.ts +2887 -0
  157. package/src/task/sync.ts +343 -0
  158. package/src/task/trigger.ts +260 -0
  159. package/src/tools/bash.ts +377 -211
  160. package/src/tools/code_run.ts +1 -1
  161. package/src/tools/delete_file.ts +1 -1
  162. package/src/tools/edit.ts +33 -6
  163. package/src/tools/evidence.ts +30 -0
  164. package/src/tools/git.ts +4 -4
  165. package/src/tools/glob.ts +12 -3
  166. package/src/tools/grep.ts +1 -1
  167. package/src/tools/lsp.ts +4 -4
  168. package/src/tools/mcp_call.ts +11 -4
  169. package/src/tools/memory.ts +153 -18
  170. package/src/tools/move_file.ts +1 -1
  171. package/src/tools/patch.ts +1 -1
  172. package/src/tools/read_file.ts +1 -1
  173. package/src/tools/read_image.ts +1 -1
  174. package/src/tools/submit_result.ts +1 -1
  175. package/src/tools/task.ts +437 -41
  176. package/src/tools/todo.ts +662 -35
  177. package/src/tools/web_fetch.ts +4 -2
  178. package/src/tools/web_search.ts +9 -3
  179. package/src/tools/write_file.ts +1 -1
  180. package/src/ui/assistant/simple.ts +123 -50
  181. package/src/ui/assistant/turn-status.ts +17 -3
  182. package/src/ui/contract.ts +184 -0
  183. package/src/ui/footer.ts +54 -18
  184. package/src/ui/i18n/en.ts +62 -6
  185. package/src/ui/i18n/id.ts +62 -6
  186. package/src/ui/input/prompt-engine.ts +120 -25
  187. package/src/ui/render/errors.ts +39 -1
  188. package/src/ui/render/markdown-table.ts +455 -0
  189. package/src/ui/render/markdown.ts +22 -1
  190. package/src/ui/render/table-grid.ts +184 -0
  191. package/src/ui/render/table.ts +15 -76
  192. package/src/ui/runtime/screen.ts +7 -2
  193. package/src/ui/runtime/statusline.ts +25 -6
  194. package/src/ui/tui/app.ts +598 -133
  195. package/src/ui/tui/transcript.ts +531 -89
  196. package/vendor/minicore/VENDOR.md +1 -1
  197. package/vendor/minicore/src/core/budget.ts +25 -25
  198. package/vendor/minicore/src/core/compact.ts +75 -75
  199. package/vendor/minicore/src/core/errors.ts +59 -59
  200. package/vendor/minicore/src/core/events.ts +73 -73
  201. package/vendor/minicore/src/core/executor.ts +139 -139
  202. package/vendor/minicore/src/core/history.ts +31 -31
  203. package/vendor/minicore/src/core/index.ts +41 -41
  204. package/vendor/minicore/src/core/loop.ts +355 -355
  205. package/vendor/minicore/src/core/permission.ts +22 -22
  206. package/vendor/minicore/src/core/provider.ts +39 -39
  207. package/vendor/minicore/src/core/recovery.ts +35 -35
  208. package/vendor/minicore/src/core/session.ts +327 -327
  209. package/vendor/minicore/src/core/snapshot.ts +146 -146
  210. package/vendor/minicore/src/core/tokens.ts +107 -107
  211. package/vendor/minicore/src/core/tool.ts +115 -115
  212. package/vendor/minicore/src/core/types.ts +50 -50
  213. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
  214. package/AGENTS.md +0 -45
  215. package/PLAN.md +0 -491
  216. package/docs/ARCHITECTURE.html +0 -1248
  217. package/docs/CONTROL-PLANE-MAP.md +0 -139
  218. package/docs/HARNESS.md +0 -150
  219. package/docs/SUMMARY.md +0 -52
  220. package/docs/UI_RENDER_PIPELINE.md +0 -165
  221. package/docs/USAGE.md +0 -11
@@ -1,4 +1,33 @@
1
- # Kontrak Terminal MiniCode (TUI fullscreen — v7, 2026-09-23)
1
+ # Kontrak Terminal MiniCode (TUI fullscreen — v7.4, 2026-10-20)
2
+
3
+ Perubahan v7.4 (P12 S2.2 WorkMode): invarian baru I35 — WorkMode (lapis
4
+ intent `DISCUSS`/`PLAN`/`EXECUTE`) sebagai dimensi TERPISAH dari permission
5
+ mode. Command `/work-mode <DISCUSS|PLAN|EXECUTE>` (aksi operator eksplisit,
6
+ transisi berlaku pada sesi yang sedang berjalan); footer menampilkan
7
+ `<WorkMode>·<permission mode>` saat WorkMode ≠ EXECUTE (`PLAN·auto`,
8
+ `DISCUSS·auto`, `PLAN·readonly`); `EXECUTE` (default) mempertahankan label
9
+ permission mode seperti sebelumnya. Tab/Shift+Tab dan `/mode` TETAP khusus
10
+ permission mode. Rincian di I35.
11
+
12
+ Perubahan v7.3 (P11 Presentation & UX): invarian baru I34 — subcommand `exec`
13
+ dan `daemon` menerima argv SCOPE dari router (flag global dikenal yang
14
+ mendahului token subcommand tetap berlaku; token subcommand tidak ikut ke
15
+ handler). Kalimat lama I28 "Flag `exec` diparse dari argv SESUDAH token
16
+ subcommand" sudah tidak lengkap sejak P11.2 menerima bentuk flag-mendahului,
17
+ diganti rujukan ke I34. Registrasi peta proteksi: `test/cli-subcommands.test.ts`
18
+ sudah ada SEBELUM P11.3 — yang ditambahkan hanya describe `cli: daemon scoped
19
+ argv (P11.3)` di dalamnya, BUKAN file baru; `test/exec-json-envelope.test.ts`
20
+ + `test/cli-session.test.ts` melindungi kontrak exec scoping (P11.2) dan
21
+ verification summary (P11.1). Nol perubahan perilaku runtime — dokumen mengejar
22
+ kontrak yang sudah diterima + diuji.
23
+
24
+ Perubahan v7.2 (2026-09-25): mouse tracking `?1002h + ?1006h`, drag selection
25
+ app-level, `Ctrl+C` copy selection, wheel tetap scroll, popup turun ke `?1000h`,
26
+ dan `MINICODE_MOUSE_SELECTION=0` sebagai kill switch.
27
+
28
+ Perubahan v7.1 (2026-09-25): mouse wheel X10/SGR untuk scroll transkrip; klik
29
+ mouse tetap diabaikan; mouse tracking dibatasi pada lifecycle TUI; `/copy [n]`
30
+ menyalin 1–10 turn terakhir; abort turn TUI memakai Esc.
2
31
 
3
32
  Perubahan v7 (temuan audit `audit-tui`): penanganan sinyal fatal
4
33
  SIGTERM/SIGHUP (I31), navigasi transkrip Home/End + Shift+PgUp/PgDn (I14),
@@ -24,8 +53,9 @@ proteksi").
24
53
  (transkrip sesi tidak di-dump ke scrollback).
25
54
  - **Non-interaktif** (one-shot prompt, `exec`, pipe/redirect/CI): cetak polos,
26
55
  tak pernah membuka TUI.
27
- - Tanpa panel/sidebar; tanpa mouse; tanpa animasi dekoratif (pulse spark
28
- status bar dapat dimatikan `MINICODE_MOTION=0` — I13).
56
+ - Tanpa panel/sidebar; mouse app-level untuk wheel scroll dan drag-selection
57
+ transkrip (bukan native terminal selection); tanpa animasi dekoratif
58
+ (pulse spark status bar dapat dimatikan `MINICODE_MOTION=0` — I13).
29
59
 
30
60
  ## Contract stdout/stderr
31
61
 
@@ -64,19 +94,29 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
64
94
  Tanpa ini SIGTERM meninggalkan terminal di alt-screen + raw mode (user harus
65
95
  `reset`).
66
96
  - App me-repaint live mengikuti event bus (stream teks, ledger, thinking;
67
- coalesce 30ms) — TANPA ini layar buta selama turn. Suspend menahan repaint
68
- (popup melukis sendiri); quit menahan semua.
97
+ coalesce 30ms) — TANPA ini layar buta selama turn. `?1002h + ?1006h`
98
+ mengaktifkan tracking drag; `?1000h + ?1006h` saat popup; `?1000l/?1002l/?1006l`
99
+ pada quit/child/sinyal. Suspend menahan repaint (popup melukis sendiri);
100
+ quit menahan semua.
69
101
  - Popup komposit (`/model`, `/provider`, `/sessions`, form, approval):
70
102
  controller/view memanggil `app.suspend()` (lepas listener stdin + redupkan
71
103
  layar), view melukis HANYA region kotak via `paintRegion` (tanpa clear —
72
104
  transkrip di belakang tetap tampil), `app.resume()` repaint penuh saat tutup.
73
105
  Tanpa suspend: byte masuk ke dua tempat (App + popup) dan frame App menimpa
74
106
  popup — dilarang.
75
- - Saat turn berjalan SEMUA input dibekukan kecuali abort (Esc/Ctrl+C) dan
76
- scroll (PgUp/PgDn). Enter saat busy = sunyi (bukan antre, bukan petunjuk).
77
- Abort pertama menampilkan hint "tekan Esc/Ctrl+C lagi untuk keluar" di slot
107
+ - Saat turn berjalan SEMUA input dibekukan kecuali abort (Esc) dan
108
+ scroll (mouse wheel, PgUp/PgDn). Enter saat busy = sunyi (bukan antre, bukan petunjuk).
109
+ Abort pertama menampilkan hint "tekan Esc lagi untuk keluar" di slot
78
110
  indikator SEKALI (anti keluar sesi tak sengaja saat double-tap "memastikan"
79
111
  — I14); abort kedua dalam 1,5 dtk = quit.
112
+ - **Checkpoint = milik lifecycle sesi.** Bus kernel memanggil handler `turn:completed`
113
+ secara sinkron dan tak menunggu promise-nya, jadi operasi tulis checkpoint
114
+ (async) harus DIMILIKI: operasi yang dimulai dicatat, kegagalannya
115
+ ditangani saat lahir (bukan unhandled rejection, bukan sukses palsu) dan
116
+ dilaporkan lewat diagnostic `[warn] checkpoint failed: …` ke stderr.
117
+ `close()` = BARRIER: setelah ia kembali, tak ada pekerjaan checkpoint milik
118
+ sesi itu yang masih berjalan (manifest sudah tertulis atau kegagalannya
119
+ sudah tercatat).
80
120
 
81
121
  ## Popup, dialog, form & i18n
82
122
 
@@ -144,38 +184,53 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
144
184
  12. Long session tetap readable (cap 5000 baris, tertua dibuang). Proyeksi
145
185
  presentasi mempertahankan cap yang sama dan menambahkan satu marker
146
186
  `… N baris awal di luar viewport — riwayat penuh di model` yang melacak
147
- jumlah baris yang di-evict; `total()` tetap monotonik.
148
-
149
- 13. Status bar: 1 baris dasar (`✦ mode • model • cwd … ctx`) dari sumber yang
150
- sama dengan angka sesi; spark pulse saat busy; `MINICODE_MOTION=0`
151
- mematikan pulse (spark statis redup — status busy tak bergantung animasi;
152
- aksesibilitas/SSH lambat/rekaman; temuan audit TUI-006), dibaca saat
153
- dipakai (bukan beku saat import).
154
- 14. Binding TUI: PgUp/PgDn scroll; **Shift+PgUp/PgDn (ESC[5;2~/6;2,
155
- modifier 2) = setengah halaman; Home/End saat prompt KOSONG = lompat
156
- baris-teratas/ekor transkrip (baris berisi = editing awal/akhir baris;
157
- dropdown terbuka = jalur engine)**; Up/Down histori; Tab/Shift+Tab mode;
158
- Ctrl+O/T compact/thinking; Ctrl+D baris-kosong keluar; Esc/Ctrl+C =
159
- batal input / abort turn (busy: SEMUA input dibekukan kecuali abort dan
160
- scroll — Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll
161
- selalu lolos agar turn bisa dibatalkan tanpa kill -9; abort pertama
162
- menampilkan hint keluar sekali). Baris kosong menampilkan placeholder +
163
- cara keluar; scroll ke atas + stream masuk = indikator `↓ N baris baru`.
187
+ jumlah baris yang di-evict; `total()` tetap monotonik. Buffer jawaban
188
+ live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
189
+ layout paint tidak boleh memproyeksikan transcript dua kali.
190
+
191
+ 13. Status bar: 1 baris dasar (`✦ 00.00.00 mode model cwd`) dari sumber
192
+ yang sama dengan angka sesi. `✦` tetap menjadi indikator proses hidup;
193
+ timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
194
+ detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
195
+ Reasoning memakai dots `...` → `..` → `.` → `..` →
196
+ `...`, sedangkan teks `Working`/`Thinking`/`Running` tidak tampil. Bullet
197
+ separator dihapus; field dipisahkan oleh spasi dan warna. Prompt `minicode ›`
198
+ tampil saat boot/idle, hilang saat busy, dan kembali otomatis setelah turn
199
+ selesai; aksi edit/histori tetap dapat membuka composer.
200
+ `MINICODE_MOTION=0` membuat dots dan sparkle statis tetapi tidak
201
+ menghilangkan feedback; satu baris kosong memisahkan composer dari footer.
202
+ 14. Binding TUI: mouse wheel (X10/SGR) scroll transkrip; drag kiri app-level
203
+ membuat selection transkrip dan `Ctrl+C` menyalinnya; PgUp/PgDn scroll;
204
+ **Shift+PgUp/PgDn (ESC[5;2~/6;2, modifier 2) = setengah halaman; Home/End
205
+ saat prompt KOSONG = lompat baris-teratas/ekor transkrip (baris berisi =
206
+ editing awal/akhir baris; dropdown terbuka = jalur engine)**; Up/Down
207
+ histori; Tab/Shift+Tab mode; Ctrl+O/T compact/thinking; Ctrl+D baris-kosong
208
+ keluar; Esc membersihkan selection lebih dulu, lalu batal input / abort
209
+ turn (busy: SEMUA input dibekukan kecuali abort, scroll, dan selection —
210
+ Enter pun sunyi; berlaku juga saat layar MENCIUT: abort+scroll selalu lolos
211
+ agar turn bisa dibatalkan tanpa kill -9; abort pertama menampilkan status
212
+ `Stopping` + hint keluar sekali, abort kedua dalam 1,5 detik menutup sesi).
213
+ Ini adalah selection buffer TUI, bukan native terminal selection. Idle
214
+ menampilkan timer redup di footer dan prompt `minicode ›`; prompt hilang
215
+ saat busy, lalu otomatis muncul kembali kosong setelah turn selesai.
216
+ Scroll ke atas + stream masuk = indikator `↓ N baris baru`.
164
217
  15. (Dihapus bersama jendela info — nomor dipertahankan.)
165
218
  16. Popup komposit: region tanpa clear + union-clear anti-hantu + clearRegion
166
219
  saat tutup + suspend/resume berpasangan; layar tak mampu = tolak bersuara
167
220
  + batal.
168
221
  17. Transkrip append-only di memori (cap 5000), viewport ikut ekor otomatis;
169
- ketikan baru kembali ke ekor; stream turn TIDAK merampas posisi baca;
170
- repaint live coalesce 30ms (layar tak buta saat turn). Proyeksi
171
- presentasi: baris running di-pin dari snapshot, elapsed tampil setelah
172
- ≥2s, status tool final memakai glyph + kata
173
- (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan
174
- grup anak mengikuti model, serta ringkasan turn masuk sebagai system
175
- entry.
222
+ ketikan baru kembali ke ekor; stream turn TIDAK merampas posisi baca;
223
+ repaint live coalesce 30ms dan clock activity 200ms (layar tak buta
224
+ saat turn). Composer memakai tinggi tetap: prompt saat editing, dots saat
225
+ reasoning, atau tool target; satu baris kosong selalu memisahkannya dari
226
+ footer. Proyeksi presentasi: baris running di-pin dari snapshot, elapsed
227
+ tetap pada ledger tool, status tool final memakai glyph + kata
228
+ (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
229
+ anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
176
230
 
177
231
  18. Prompt multiline (Ctrl+J newline), histori memori-sesi (tak persist ke
178
- berkas histori lama).
232
+ berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
233
+ oldest-to-newest) melalui OSC 52.
179
234
  19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
180
235
  20. Lebar kotak popup TETAP per permukaan (model 64, picker 64, provider 76,
181
236
  form 64 — min=max); nama/ID di depan label; seleksi murni warna; search
@@ -188,8 +243,9 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
188
243
  di footer form ("batal dalam 10 dtk" — bukan countdown hidup), 10 dtk
189
244
  berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
190
245
  ketikan apa pun me-reset kedua timer.
191
- 22. Thinking terlihat: minimized = penanda `… thinking` + isi di `/expand`;
192
- expanded = alir redup; fase berakhir = commit (tak ada thinking yatim).
246
+ 22. Thinking terlihat: composer memakai dots clock; transkrip minimized =
247
+ bersih tanpa marker (`… thinking`), expanded = alir redup; isi tetap
248
+ tersedia di `/expand`; fase berakhir = commit (tak ada thinking yatim).
193
249
  23. Approval & ask_user tercatat di transkrip (pertanyaan + keputusan) dan
194
250
  terlihat sebelum menjawab; non-TTY = deny/null fail-closed; stdout
195
251
  di-pipe tanpa sink TUI = deny/null (prompt tak terlihat + mencemari
@@ -235,8 +291,8 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
235
291
  positional id = salah pakai (exit 2). `exec --json` yang gagal di fase
236
292
  setup (tanpa provider) TETAP memancarkan satu baris `{"type":"summary",
237
293
  "ok":false,…}` (di-scrub) di stdout — pipeline CI tak pernah menerima
238
- stream kosong; jalur manusia (stderr + exit 1) tidak berubah. Flag `exec`
239
- diparse dari argv SESUDAH token subcommand.
294
+ stream kosong; jalur manusia (stderr + exit 1) tidak berubah. Flag
295
+ handler `exec`/`daemon` dibaca dari argv scope — lihat I34.
240
296
  29. `minicode acp` = server JSON-RPC stdio satu-JSON-per-baris untuk IDE
241
297
  (subset: `initialize`/`run`/`cancel`/`shutdown`; BUKAN klaim ACP penuh):
242
298
  stdout murni mesin (semua di-scrub), diagnostik manusia ke stderr,
@@ -251,21 +307,74 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
251
307
  listener `resize` baru (frame basi cukup ditimpa render berikutnya), dan
252
308
  `printedW` tidak ikut di-reset — nilainya konservatif; dikosongkan justru
253
309
  membiarkan ekor lama.
310
+ 34. Routing argv-scope (P11.2/P11.3): handler `exec` dan `daemon` menerima
311
+ argv SCOPE dari router — flag global dikenal yang mendahului token
312
+ subcommand tetap berlaku, token subcommand dibuang, urutan token
313
+ sisanya utuh. Ditunjukkan tes: `--json exec "t"` identik dengan
314
+ `exec --json "t"` (prompt model = teks user persis, tanpa token
315
+ routing maupun nilai flag); `--json daemon status` mencapai aksi
316
+ `status` alih-alih error subcommand asing; aksi/opsi yang tidak
317
+ dikenal TETAP salah pakai sesuai I28; posisi argumen pertama
318
+ (prompt/aksi) tidak bergeser. Hanya kedua handler itu menerima scope
319
+ — subcommand lain menerima args mentah. Invarian ini tidak mengubah
320
+ semantik, aksi, atau exit code masing-masing aksi; yang berubah hanya
321
+ invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
322
+ 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2)** — dua
323
+ dimensi yang BERJALAN BERSAMA, bukan pengganti:
324
+ **Nilai:** `DISCUSS` (read-only penuh) · `PLAN` (ceiling rencana) ·
325
+ `EXECUTE` (tanpa ceiling tambahan). Default `EXECUTE` = perilaku lama
326
+ (kompatibel: sesi tanpa WorkMode yang eksplisit tetap EXECUTE).
327
+ **Gerbang penolakan:** permission handler tetap satu-satunya yang menentukan
328
+ keamanan eksekusi. WorkMode hanya MEMASANG CEILING di atasnya; ia tidak
329
+ pernah memperluas kewenangan permission mode dasar (INV-WM1).
330
+ **Command `/work-mode <DISCUSS|PLAN|EXECUTE>`:** aksi operator EKSPLISIT.
331
+ Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
332
+ kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
333
+ (handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
334
+ diam-diam tampak berubah. Transisi berlaku pada SESI YANG SEDANG
335
+ BERJALAN: ceiling permission dievaluasi per pemanggilan tool, daftar tool
336
+ yang dilihat model ikut turun/naik, hooks dievaluasi terhadap WorkMode
337
+ aktif, dan delegasi berikutnya mewarisi WorkMode parent yang aktif.
338
+ WorkMode TIDAK bisa dinaikkan otomatis oleh model, anak, atau argumen
339
+ delegasi.
340
+ **Pemisahan dari permission mode:** Tab/Shift+Tab dan `/mode` TETAP
341
+ khusus permission mode — WorkMode tak masuk siklus Tab. Permission mode
342
+ yang memutuskan allow/deny per tool; WorkMode memilih postur
343
+ (diskusi/rencana/bebas) dan hanya mempersempit.
344
+ **Hooks:** gate `shouldRunHooks(permissionMode, workMode)` dievaluasi
345
+ **per pemanggilan** dengan WorkMode **AKTIF** (transisi `/work-mode`
346
+ langsung berlaku); sisi permission mode memakai **nilai startup sesi**
347
+ (semantik lama dipertahankan — `Tab`/`Shift+Tab` menggeser mode izin di
348
+ dalam handler, bukan nilai gate hooks). WorkMode `DISCUSS` tetap menahan
349
+ hook walau permission mode `auto`.
350
+ **Footer:** mode WorkMode aktif tampil sebagai
351
+ `<WorkMode>·<permission mode>` hanya saat WorkMode ≠ EXECUTE (mis.
352
+ `PLAN·auto`, `DISCUSS·auto`, `PLAN·readonly`); saat EXECUTE label
353
+ permission mode apa adanya (mis. `auto`) — perilaku lama dipertahankan.
254
354
 
255
355
  ## Grammar (ringkas)
256
356
 
257
- prompt `minicode ›` (+ placeholder & cara keluar saat kosong; dropdown `/`
258
- berbingkai di atasnya) · status bar = 1 baris · ledger tool
357
+ prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
358
+ berbingkai di atasnya) ·
359
+ status bar `✦ 00.00.00 mode model cwd` (timer redup idle; detik putih aktif,
360
+ menit mulai terang di 60 dtk, jam di 1 jam; tanpa bullet separator; mode =
361
+ permission mode, atau `<WorkMode>·<permission mode>` bila WorkMode ≠ EXECUTE)
362
+ + satu spacer sebelum footer · ledger tool
259
363
  ` › name target` (hijau) / merah saat error · error `✗ pesan` sekali per
260
- kegagalan · thinking: `… thinking` / alir redup · popup: konten redup di
364
+ kegagalan · pesan error TUI = formatter kanonik (`formatError`,
365
+ `src/ui/render/errors.ts`): credential di-redaksi (bearer/key/query), escape
366
+ ANSI dibuang, body provider diringkas + dipotong; `e.message` mentah tak
367
+ pernah tampil · thinking: dots clock / alir redup · popup: konten redup di
261
368
  belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
262
369
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
370
+ `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
263
371
  Projection V2: `› name target … running`, ledger status ber-glyph/kata,
264
372
  retry/grup anak, ringkasan turn, dan marker evict sesuai flag ·
265
373
 
266
- `Ctrl+C`/`Esc` saat turn = abort (+ hint sekali); busy = input beku total ·
267
- PgUp/PgDn = scroll, Shift+PgUp/PgDn = setengah halaman, Home/End (prompt
268
- kosong) = lompat top/ekor · indikator `↓ N baris baru` · tab dihitung 8 kolom (batas atas stop
374
+ `Esc` saat turn = abort (+ hint sekali); busy = input beku total ·
375
+ Mouse wheel = scroll transkrip, PgUp/PgDn = scroll, Shift+PgUp/PgDn = setengah
376
+ halaman, Home/End (prompt kosong) = lompat top/ekor · indikator `↓ N baris baru` ·
377
+ tab dihitung 8 kolom (batas atas stop
269
378
  terminal — tak pernah undercount) · C1/bidi/tag dibuang dari teks
270
379
  tak-terpercaya (sanitasi) · truncate/chunk hanya menyalin SGR (non-SGR
271
380
  dibuang) · penanda `(aktif)` di luar budget truncasi (tak termakan URL
@@ -283,21 +392,55 @@ panjang).
283
392
  sampai PgDn), tapi prompt jawaban + bell selalu terlihat di bawah.
284
393
  6. Area yang dibuka kembali saat kotak menyusut = kosong (bukan transkrip
285
394
  di belakangnya) sampai popup tutup + repaint penuh.
395
+ 7. Jalur end-to-end mouse SGR bergantung pada TRANSPORT PTY: kalau byte SGR
396
+ tak sampai ke stdin anak, selection → OSC52 tak bisa diverifikasi lewat
397
+ byte stream nyata. Pada lingkungan diagnostik Windows (ConPTY + node-pty
398
+ 1.2.0-beta.15) byte SGR terbukti sampai ke anak yang membaca dalam raw
399
+ mode — kegagalan lama yang disangka "ConPTY membuang SGR" adalah artefak
400
+ line buffering probe, bukan keterbatasan transport. Perilaku platform lain
401
+ belum diuji; capability gate mengukur kemampuannya secara langsung
402
+ (bukan asumsi platform): di luar CI Linux, SGR yang memang tak diantarkan
403
+ → SKIP beralasan; di CI Linux jalur SGR end-to-end WAJIB terverifikasi,
404
+ jadi probe yang verdict-nya bukan "supported" → GAGAL dengan diagnosa
405
+ (bukan skip senyap yang menghapus coverage).
286
406
 
287
407
  ## Peta proteksi (test → invariant)
288
408
 
289
- - `test/tui-app.test.ts` — I1/I14/I17-I20 (boot/exit pairing, transcript viewport,
290
- scroll + indikator, prompt + placeholder, status bar, quit, suspend/resume,
291
- busy-freeze, live repaint; I14: abort/scroll lolos saat menciut; I17: kunci
292
- posisi baca + basis monotonik).
409
+ > **Cara membaca peta ini.** Setiap baris hanya boleh menyatakan perilaku yang
410
+ > **benar-benar di-assert** oleh test yang disebut. Kehadiran nama file test
411
+ > bukan bukti klaim. Baris yang hanya "nominal" (test ada, tapi assertion-nya
412
+ > tak menyentuh perilaku yang diklaim) dipindah ke bagian
413
+ > [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup) di bawah — jangan
414
+ > dipoles dengan mengganti kata-kata.
415
+
416
+ - `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (boot/exit pairing, transcript
417
+ viewport, mouse-wheel/drag-selection/PgUp/PgDn scroll + indikator, prompt
418
+ editing, dots/timer, status bar, Esc-only abort, quit, suspend/resume,
419
+ busy-freeze, live repaint; I14: Home/End jump + Shift+PgUp/PgDn + hint abort
420
+ pertama ada di `test/tui-audit-fixes.test.ts`, bukan di file ini; I17: kunci
421
+ posisi baca saat stream masuk; basis monotonik ada di
422
+ `test/tui-transcript.test.ts` + `test/presentation-projections.test.ts`;
423
+ P0: jalur error TUI meredaksi credential — sentinel bearer tak pernah tampil
424
+ di layar).
425
+ - `test/prompt-engine.test.ts` — decoder streaming CSI/SGR/X10: wheel menjadi key scroll, klik mouse tidak masuk teks.
426
+ - `test/errors-usage.test.ts` — format error UI: `formatError` (kanonik untuk TUI/wizard/one-shot) meredaksi credential (bearer, kunci provider, query, token di batas potong 150 kolom), membuang escape ANSI, memetakan kategori/kind provider, dan menjaga pesan biasa tetap informatif.
427
+ - `test/checkpoint-lifecycle.test.ts` — checkpoint = milik lifecycle sesi: manifest tersedia saat `close()` kembali (barrier), tak ada operasi yang tertinggal, kegagalan checkpoint tercatat + dilaporkan tanpa unhandled rejection, dan semua operasi dari beberapa turn selesai saat drain.
428
+ - `test/tui-transcript.test.ts` — projection source-mapped: wrap, CJK/ANSI, user prefix, tabel TSV, selection text, cap buffer live, dan render markdown inline jawaban model (heading/bold/code; delimiter fence disembunyikan, isi fence dan gema user tetap literal).
293
429
  - `test/screen-buffer.test.ts` — parser frame harness (unit).
294
- - `test/tui-transcript.test.ts` — I7/I12/I17/I22/I24 (ledger, cap, viewport,
295
- thinking, buffer /expand; total() monotonik kebal evict).
296
- - `test/presentation-projections.test.ts` — I12/I17/I26/I32 (projection
430
+ - `test/tui-transcript.test.ts` — I7/I12/I17/I22 (ledger satu baris per tool, cap 5000 + marker evict, `total()` monotonik kebal evict, viewport, thinking minimized/expanded).
431
+ - `test/presentation-projections.test.ts` — I12/I17/I32 (projection
297
432
  snapshot, running/elapsed, status terminal, retry/child grouping, summary,
298
- marker evict, dan parity flag OFF).
299
- - `test/presentation-linear-acp.test.ts` — I2/I6/I28/I33 (linear projection
300
- status/duration/receipt dan lifecycle ACP terstruktur).
433
+ marker evict + `total()` monotonik, dan parity flag OFF).
434
+ - `test/presentation-linear-acp.test.ts` — I33 (linear projection
435
+ status/duration/receipt dan lifecycle ACP terstruktur; parity policy-vs-legacy).
436
+ - `test/presentation-policy.test.ts` — I32/I33 (seleksi node per mode, envelope
437
+ machine, digest divergensi; purity tanpa clock/IO).
438
+ - `test/writer-inventory.test.ts` — OAP-008 (setiap writer langsung terdaftar
439
+ dengan owner; jumlah tak boleh naik diam-diam).
440
+ - `test/exec-json-envelope.test.ts` + `test/cli-session.test.ts` (envelope
441
+ machine) — I28/I33/I34 (summary berversi, tanpa ANSI/secret, tanpa raw
442
+ kernel; P11.2 scoping prompt: flag-mendahului vs `exec`-dahulu identik,
443
+ kata `exec` milik user tetap utuh).
301
444
 
302
445
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
303
446
  anti-hantu).
@@ -305,17 +448,56 @@ panjang).
305
448
  Esc-1 kembalikan prefill, Esc-2 batal).
306
449
  - `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
307
450
  stdout-pipe tanpa sink = deny).
308
- - `test/footer-render.test.ts` — I13.
309
- - `test/terminal-contract.test.ts` — I2/I3/I5/I7/I8/I9/I12.
451
+ - `test/footer-render.test.ts` — I13 (footer minimal tanpa label status).
452
+ - `test/work-mode-runtime.test.ts` — I35 (WorkMode runtime: ceiling permission
453
+ dievaluasi per pemanggilan tool; transisi EXECUTE↔DISCUSS↔PLAN pada sesi
454
+ yang sama; daftar tool yang dilihat kernel ikut berubah; hooks mengikuti
455
+ WorkMode aktif; delegasi mewarisi WorkMode parent terbaru; argumen
456
+ delegasi tak bisa menaikkan WorkMode; `/work-mode` end-to-end lewat TUI
457
+ termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; label
458
+ footer `PLAN·auto`/`DISCUSS·auto`).
459
+ - `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
460
+ handler PM: 18 sel matriks, gerbang approval `PLAN × auto/ask`, `describeDenial`
461
+ per pemilik keputusan, `always`/K-1 tetap utuh, `__setMode` tak mencabut
462
+ ceiling).
463
+ - `test/work-mode-tool-visibility.test.ts` — I35 (visibilitas tool = irisan
464
+ permission mode ∧ WorkMode; `PLAN × readonly` tak memperluas readonly;
465
+ tool MCP ikut dibatasi).
466
+ - `test/work-mode-hooks.test.ts` — I35 (hooks: `DISCUSS` menahan, `PLAN`/
467
+ `EXECUTE` mengikuti permission mode; pemanggil lama tanpa WorkMode kompatibel).
468
+ - `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
469
+ tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
470
+ - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > default
471
+ EXECUTE; nilai invalid → EXECUTE + peringatan; ACP `workMode` terpisah dari
472
+ `mode`).
473
+ - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
474
+ editing/busy, dots clock, timer, cursor, resize, popup). *Klausul "satu baris
475
+ kosong memisahkan composer dari footer" TIDAK punya assertion — lihat
476
+ [Gap proteksi](#gap-proteksi-terbukti-belum-ditutup).*
477
+ - `test/markdown-table.test.ts` — I8/I11 (pipe-table parser, streaming
478
+ parity, ANSI/CJK width, TTY/non-TTY, TUI resize, machine-output policy).
479
+ - `test/terminal-contract.test.ts` — I2/I3/I7/I8/I9 (split stdout/stderr,
480
+ kepemilikan layar tunggal, ledger satu baris per tool, streaming tanpa
481
+ duplikasi, foreign writer boleh mentah).
310
482
  - `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
311
483
  picker/askLine, nesting, delayMs).
312
- - `test/statusline-bun-guard.test.ts` — I4/I5.
313
- - `test/turn-status.test.ts` — I5.
314
- - `test/tui-format.test.ts` — I2/I7/I8 (preview arg sanitasi satu-baris).
484
+ - `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
485
+ dinonaktifkan sendiri, write asli dipulihkan).
486
+ - `test/turn-status.test.ts` — garis status turn lifecycle deterministik
487
+ (grace 250 ms, latch anti-strobe, pembersihan saat `endTurn`).
488
+ - `test/tui-format.test.ts` — I2/I7/I8 (preview arg sanitasi satu-baris;
489
+ stdout = output program / stderr = ledger; 20 tool berurutan = 1 baris
490
+ masing-masing tanpa overlap) + **I18** (envelope OSC52 `/copy` benar saat
491
+ TTY, ditolak tanpa TTY, dan 1–10 turn terakhir oldest-to-newest).
315
492
  - `test/theme.test.ts` — I6 (strip DCS/APC/PM/SOS + final CSI non-huruf).
316
- - `test/ansi-fragmentation.test.ts` — I6/I8.
493
+ - `test/ansi-fragmentation.test.ts` — I6/I8 (setiap titik split ≡ string utuh).
317
494
  - `test/non-tty-output.test.ts` — I6.
318
- - `test/thinking-truncation.test.ts` — I12.
495
+ - `test/thinking-truncation.test.ts` — I12 (buffer thinking >200 KB → `/expand`
496
+ membawa marker truncasi).
497
+ - `test/collapse.test.ts`, `test/presentation-expand.test.ts`,
498
+ `test/presentation-store.test.ts` — **I24** (semantik `/expand` pada Content
499
+ Store: buka-ulang identik, dengan id vs tanpa id, miss → durable sqlite +
500
+ penanda retensi).
319
501
  - `test/ui-combined.test.ts` — DIHAPUS bersama chrome.
320
502
  - `test/repl-linear.test.ts`, `test/footer-chrome.test.ts`,
321
503
  `test/info-window.test.ts` — DIHAPUS bersama REPL/chrome/jendela.
@@ -328,7 +510,9 @@ panjang).
328
510
  LC_ALL > LANG, string kosong diabaikan).
329
511
  - `test/i18n-hardcode.test.ts` — I26 (lexer sadar-state: tanpa literal
330
512
  Indonesia di luar kamus; kontrol positif id.ts kena, negatif en.ts bersih).
331
- - `test/tui-lang.test.ts` — I26/I24 (/lang end-to-end, /help satu sumber).
513
+ - `test/tui-lang.test.ts` — I26 (locale sesi `/lang` end-to-end + persisten;
514
+ nilai tak dikenal ditolak) + I24 (`/help` satu sumber; `/copy 2` menyalin dua
515
+ turn terakhir).
332
516
  - `test/cli-help-language.test.ts` — I26/I25 (label en, kelengkapan /help).
333
517
  - `test/tui-geometry.test.ts` — I20/I25 (lebar tetap per permukaan, step
334
518
  wizard, form error).
@@ -340,6 +524,10 @@ panjang).
340
524
  hermetic subprocess).
341
525
  - `test/exec-json-envelope.test.ts` — I28 (summary ok:false di stdout saat
342
526
  setup gagal; jalur manusia tak berubah).
527
+ - `test/cli-subcommands.test.ts` — I34 (daemon scoped argv: `--json daemon
528
+ status` mencapai aksi `status`, bukan exit 2 palsu; bentuk `daemon`-dahulu
529
+ tidak berubah; aksi asing tetap exit 2; HOME hermetik, exit 3 not-alive
530
+ mengikuti kontrak daemon yang sudah ada — bukan klaim baru I34).
343
531
  - `test/acp.test.ts` — I29 (parser/framing/params + smoke spawn stdio:
344
532
  initialize→shutdown exit 0, tanpa provider).
345
533
  - `test/input-resize.test.ts` — I30 (gagal di kode lama: CUP `\x1b[1A` ke
@@ -359,9 +547,33 @@ panjang).
359
547
  ESC[5;2~; hint abort pertama), I13 (MINICODE_MOTION=0: spark statis,
360
548
  env dibaca saat dipakai), I25 (kursor CUP parkir di dalam blok ?2026 yang
361
549
  sama), I21 (konstanta idle form 80+10 dtk + teks peringatan).
362
- - `test/pty.test.ts` — I17/I31/I28 via BYTE STREAM NYATA (harness PTY
550
+ - `test/pty.test.ts` — I13/I17/I31/I28 via BYTE STREAM NYATA (harness PTY
363
551
  `test/helpers/pty-harness.ts`, CLI di pseudo-terminal sesungguhan +
364
- provider fake hermetic): boot → ?1049h + prompt, turn penuh end-to-end,
365
- SIGTERM → restore + exit 143 (POSIX), resize → repaint, exec --json
366
- bersih tanpa ANSI. Platform tak mampu (ConPTY rusak) = SKIP beralasan,
367
- bukan hijau palsu.
552
+ provider fake hermetic): boot → ?1049h + timer idle, turn penuh end-to-end,
553
+ drag-selection mouse SGR → Ctrl+C → OSC52 (koordinat mouse dihitung dari
554
+ LAYAR NYATA, bukan hardcoded), resize → repaint, SIGTERM → restore + exit
555
+ 143 (POSIX). *Klausa "exec --json bersih tanpa ANSI" di test ini berjalan
556
+ sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
557
+ bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
558
+ Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
559
+ Jalur mouse SGR punya capability gate (`ptySgrMouseDelivered()`): transport
560
+ yang TAK mengantarkan byte SGR → SKIP beralasan; probe tak konklusif → SKIP
561
+ dengan alasan "tak konklusif" (BUKAN bukti SGR tak didukung); di CI Linux
562
+ verdict WAJIB "supported" — selain itu test SGR GAGAL dengan diagnosa, bukan
563
+ skip senyap. Parser SGR dan selection SGR tetap terverifikasi terpisah di
564
+ `test/prompt-engine.test.ts` dan `test/tui-app.test.ts` (fake TTY).
565
+
566
+ ### Gap proteksi (terbukti, belum ditutup)
567
+
568
+ Bagian ini menahan klaim yang **benar secara implementasi tetapi belum punya
569
+ assertion** yang menjaganya. Menutup gap = menambah test; mengubah
570
+ kata-kata di sini TIDAK menutup gap.
571
+
572
+ | Klaim | Status implementasi | Yang hilang |
573
+ |---|---|---|
574
+ | I14 — "berlaku juga saat layar MENCIUT: abort+scroll selalu lolos" | Terimplementasi (`src/ui/tui/app.ts`: scroll/abort tetap lolos saat `tooSmall()`) | Tidak ada assertion. `test/tui-app.test.ts` ("terminal menciut tengah sesi") hanya asserting bahwa ketikan diabaikan + `Ctrl+D` keluar. |
575
+ | I13/I17 — "satu baris kosong memisahkan composer dari footer" | Terimplementasi (`src/ui/tui/app.ts` merender satu spacer per frame) | Kata "spacer" tidak muncul di berkas test mana pun — tak ada assertion tinggi-geometry maupun rendah. |
576
+ | I20 — lebar kotak popup tetap per permukaan | Terimplementasi | `test/tui-app.test.ts` menandai salah satu test-nya sebagai `(I20)`, padahal test itu milik I13 (status bar). Lebar popup diverifikasi di `test/tui-geometry.test.ts` + `test/dialog.test.ts`; label di `tui-app` menyesatkan. |
577
+ | I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
578
+ | I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
579
+ | I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
@@ -2,7 +2,7 @@
2
2
 
3
3
  Peta struktur hidup yang interaktif ada di `ARCHITECTURE.html` (file pendamping di folder ini — search/filter, 9 section `00 Sekilas` → `09 UI/UX rendering terminal`). Halaman ini ringkasannya agar bisa dibaca GitBook + AI Ask.
4
4
 
5
- Rencana aktif: `PLAN.md` (root). Kontrak terminal FROZEN: `TERMINAL_CONTRACT.md` (folder ini) — baca sebelum menyentuh output/rendering; perubahan perilaku wajib update dokumen + test peta proteksinya. Riset harness: `HARNESS.md` (folder ini). Arsip: `PLAN_UIUX_V6.md` (selesai, jangan dikerjakan ulang).
5
+ Rencana aktif: **roadmap arsitektur = `ROADMAP.md` di root repo** (master roadmap milik pemilik, disalin 2026-10-21) — di situulah posisi Big Phase P1–P14, next action arsitektur, dan status track Quality Remediation. `PLAN.md` di root tetap ada sebagai **ledger produk/milestone legacy** (`LEGACY-0.9/*`), bukan sumber status fase (lihat tabel disambiguasi di `AGENTS.md`). Kontrak terminal FROZEN: `TERMINAL_CONTRACT.md` (folder ini) — baca sebelum menyentuh output/rendering; perubahan perilaku wajib update dokumen + test peta proteksinya. Audit dan target output architecture: [OUTPUT_ARCHITECTURE_AUDIT.md](OUTPUT_ARCHITECTURE_AUDIT.md) beserta [event model](OUTPUT_EVENT_MODEL.md), [protocol](OUTPUT_PROTOCOL_SPEC.md), [rendering](OUTPUT_RENDERING_SPEC.md), [UX](OUTPUT_UX_RULES.md), dan [implementation plan](OUTPUT_IMPLEMENTATION_PLAN.md). Riset harness: `HARNESS.md` (folder ini). Arsip: `PLAN_UIUX_V6.md` (selesai, jangan dikerjakan ulang).
6
6
 
7
7
  ## Tiga lapisan
8
8
 
@@ -14,12 +14,91 @@ L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (freeze, zero-dep, via #m
14
14
 
15
15
  - `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
16
16
  - Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
17
- - DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `createProviderLayer → loadLastModel → createRagLayer → resume + planRecovery + reconcileUndoRedo → setupToolLayer + setAskTextFn → createMinicodeSession → journal + checkpoint + step-trace + runPromptWithVerify (baseline-first + self-heal 3 siklus + hooks) → logger + turn-status + usage/pricing → persist/finalize → close (kill jobs, mcp/lsp close)`. `setSubAgentSessionFactory` sebelum dispatch agar REPL/one-shot/`mcp serve` tercakup.
17
+ - DI dari composition root (`cli/index.ts`, `cli/setup.ts`): `createProviderLayer → loadLastModel → createRagLayer → resume presentation-events + planRecovery + reconcileUndoRedo → setupToolLayer + setAskTextFn → createMinicodeSession → journal + checkpoint + semantic event sink + step-trace + runPromptWithVerify (baseline-first + self-heal 3 siklus + hooks) → logger + turn-status + usage/pricing → persist/finalize → close (kill jobs, mcp/lsp close)`. `setSubAgentSessionFactory` sebelum dispatch agar TUI/one-shot/`mcp serve` tercakup.
18
18
  - `providers → config` satu arah (`src/providers/provision.ts` provisioning, `src/config.ts` murni IO).
19
19
 
20
20
  ## Alur satu prompt
21
21
 
22
- `prompt → permission check → validateArgs (kernel) → executor (order/cap/abort-aware) → tool realpath+atomic → execute → checkpoint shadow-git + journal + step-trace → compaction (mekanikal sinkron; LLM async via seam `compactAsync`) → usage/pricing per-segmen longest-key → trace`.
22
+ `prompt → permission check → validateArgs (kernel) → executor (order/cap/abort-aware) → P2.10 canonical tool wrapper (await EffectIntent → execute → await EffectReceipt) → tool realpath+atomic → checkpoint shadow-git + journal + step-trace → compaction (mekanikal sinkron; LLM async via seam `compactAsync`) → usage/pricing per-segmen longest-key → trace`.
23
+
24
+ ## Konteks & state durable
25
+
26
+ Konteks model adalah **working memory**, bukan state. Tiga lapis yang berbeda
27
+ dutinya:
28
+
29
+ | Lapis | Isi | Authoritatif untuk |
30
+ |---|---|---|
31
+ | Kernel `ContextStore` | history yang dikirim ke model, bisa lossy saat kompaksi | window berjalan |
32
+ | Tabel `messages` (durable) | `role, content, toolCalls, toolCallId, name, reasoning, is_error` | continuity/resume |
33
+ | Vektor memory + `presentation_events` | ringkasan compaction, evento semantik | RAG & audit UI |
34
+
35
+ `context_eviction ≠ state_loss`: memangkas yang working boleh, hilang dari
36
+ durable tidak. Karena itu pagu summary kompaksi
37
+ (`LIMITS.COMPACTION_SUMMARY_MAX_CHARS`) aman dipakai — fakta penuh tetap ada di
38
+ `messages` dan vektor memory.
39
+
40
+ Fidelity resume: `reasoning` (thinking) dan `is_error` (tool gagal) adalah
41
+ field kernel `Message` yang ikut dibawa ke history. Semula keduanya tidak punya
42
+ kolom, sehingga resume menghasilkan konteks buta. Keduanya kini jadi kolom
43
+ `messages` dan **wajib ikut prefix comparison** di `saveSession` — kalau tidak,
44
+ perubahan hanya pada `reasoning`/`is_error` dianggap "tak berubah" dan
45
+ incremental append melewatkannya (kelas bug F-05). Kolom ditambahkan additive,
46
+ jadi DB lama tetap terbaca dan turn lama resume dengan field absen.
47
+
48
+ Penulisan tetap incremental: `saveSession` hanya insert baris baru saat prefix
49
+ sama, bukan menulis ulang seluruh history. Ini alasannya sidecar JSON per-turn
50
+ pernah ditolak — history 400 pesan terukur 62 ms encode + 53 ms blob write tiap
51
+ turn (O(history)), jadi ~115 ms per turn, sementara jalur `messages` bersama
52
+ prefix-compare 10 ms.
53
+
54
+ ## Task system (state kerja durable)
55
+
56
+ Task state **bukan** chat history dan **bukan** tool trace. Owner semantiknya
57
+ `src/tools/todo.ts`; `.minicode/todos/<id>.json` adalah satu-satunya sumber
58
+ kebenaran, dan `plan.updated` (event durable untuk ACP/`exec --json`) hanyalah
59
+ **proyeksi** dari file itu.
60
+
61
+ ```text
62
+ todo_write (model) ─► normalizeTodos ─► .minicode/todos/<id>.json (state)
63
+ │ ▲
64
+ │ │ setCompletionEvidence
65
+ │ bukti verify terakhir
66
+ ▼
67
+ plan.updated (proyeksi, terbit SETELAH tool sukses)
68
+ ```
69
+
70
+ Tiga aturan yang menjaga domain ini:
71
+
72
+ 1. **Identitas sesi kanonik (P2.1).** Todo terikat ke `sid` kanonik dari
73
+ `resolveSessionIdentity` (`src/session/identity.ts`), bukan id volatil
74
+ proses (`bootId`). `--resume` tanpa `--session` tidak lagi menempa id
75
+ acak; `--resume` tak dikenal gagal eksplisit (`SESSION_NOT_FOUND`).
76
+ 2. **Completion butuh bukti.** `setCompletionEvidence()` menyuntikkan verdict (`unverified` | `passed` | `failed`) dari composition root. `failed` menolak
77
+ `completed` → task jadi `blocked` + alasannya, dan hasilnya dilaporkan ke
78
+ model. Default `unverified` menjaga pemakaian tanpa `--verify` tetap
79
+ POSSIBLE; yang dilarang adalah completion diam-diam tanpa jejak.
80
+ 3. **Satu normalizer, dua store.** `planFromTodos` ( adaptor) memanggil
81
+ `normalizeTodos` yang sama dengan file, sehingga status/cap/`blocked` tidak
82
+ bisa berbeda arah — dan plan event terbit di `execution:completed`, bukan
83
+ dari argumen sebelum tool jalan.
84
+
85
+ Batas subsystem **todo** (lihat `docs/TASK_ARCHITECTURE_AUDIT.md` untuk
86
+ audit historisnya): file todo tetap datar — tanpa field dependency di
87
+ `TodoItem`, tanpa surface user (`/tasks`), `/undo` hanya revert file (todo
88
+ tetap `completed`), dan tanpa TTL/GC untuk file todo di luar SQLite.
89
+ Dependency/graph dan scheduler **sudah ada**, tetapi pada subsystem terpisah:
90
+ TaskGraph + Scheduler di `src/task/` beroperasi di atas TaskStore
91
+ (`.minicode/tasks.db`), bukan di atas file todo; `todo_write` hanya boleh
92
+ menyentuhnya lewat `taskId` kanonik (`src/tools/todo.ts`), dan control
93
+ surface-nya `/scheduler` (off by default).
94
+
95
+ ## Bukti verifikasi (P2.10)
96
+
97
+ `src/session/verification.ts` + `src/tools/evidence.ts` menulis identitas
98
+ invokasi, intent pra-efek, receipt pasca-eksekusi, dan observasi eksplisit ke
99
+ jurnal mutasi yang sama (`src/session/journal.ts`). `committed` berarti return
100
+ tool terobservasi, bukan efek eksternal terbukti; `pending` tetap UNKNOWN.
101
+ Verifikasi tak menulis `messages`, proyeksi, presentasi, Run, atau kursor.
23
102
 
24
103
  ## UI/UX terminal (kontrak FROZEN)
25
104
 
@@ -31,14 +110,17 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
31
110
  | stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY |
32
111
  | Keduanya | Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe |
33
112
 
34
- 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. 30 invariant (I1–I30) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`.
113
+ 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.
35
114
 
36
- Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris `✦ mode • model • cwd … ctx` (spark pulse saat busy, redup saat idle, konteks rata kanan; `src/ui/tui/app.ts` render per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup + penanda `… thinking` (isi via `/expand`); error `✗ pesan actionable` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
115
+ Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris `✦ 00.00.00 mode model cwd` (timer redup idle; saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; konteks rata kanan; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `✗ pesan actionable` sekali per kegagalan (`takePendingError`). `✓`/`✗` tetap untuk status/konfirmasi perintah (sync, auth, config, spinner).
37
116
 
38
117
  ## Modul kunci
39
118
 
40
- - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `markdown.ts highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
41
- - `src/ui/input/`: `askLine`, `prompt-engine` (grapheme `Intl.Segmenter`, streaming decoder, bracket-paste, mouse dibuang).
119
+ - `src/session/verification.ts` + `src/tools/evidence.ts`: identitas invokasi milik aplikasi, intent/receipt yang di-await, observasi eksplisit, idempotency, dan korelasi efek anak — semuanya di jurnal mutasi yang sama.
120
+
121
+ - `src/ui/render/`: `theme.ts` (getter `c`/`glyphs`), `width.ts` (kolom), `sanitize.ts` (hanya SGR lewat), `markdown.ts`, `markdown-table.ts` (parser pipe-table streaming), `table-grid.ts` (grid budget terminal), `highlight.ts diff.ts table.ts wrap.ts money.ts errors.ts`.
122
+ - `src/presentation/`: `events.ts` (25 semantic event types + proposed marker), `adapter.ts` (runtime → DomainEvent), `reducer.ts`/`model.ts` (replayable bounded state + derived summary), `store.ts` (content refs), `projection.ts` (policy node/mode + envelope `minicode.output.v1` + kategori error machine, murni), dan `src/session/persistence.ts` (`presentation_events` durable log + `messages` dengan fidelity `reasoning`/`is_error`). `cli/setup.ts` memiliki exhaustive `toPresentationEvent()` bridge; renderer TUI/linear/machine memakai keputusan policy via injeksi `PresentationPolicy` (rollback flag dihapus di Phase 8).
123
+ - `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).
42
124
  - `src/ui/screens/`: view murni `picker/overlay/wizard/model-manager/provider-manager`.
43
125
  - `src/ui/assistant/simple.ts`: printer linier + clipboard OSC52. `turn-status.ts`: garis transient. `approval/prompt.ts`: `promptAsk/promptAskText`.
44
126
  - Kualitas: `bench/`, `scripts/` (coverage/pack/telemetry/vendor), `experiments/` (adversarial).
package/docs/changelog.md CHANGED
@@ -1,3 +1,3 @@
1
1
  # Changelog
2
2
 
3
- Riwayat rilis dan status eksekusi kini digenerate otomatis dari [`PLAN.md`](../PLAN.md) saat build website — lihat [changelog di website](https://minicode.fun/docs/changelog.html).
3
+ Riwayat rilis dan status eksekusi kini digenerate otomatis dari `PLAN.md` (berkas repo, tidak ikut paket npm) saat build website - lihat [changelog di website](https://minicode.fun/docs/changelog.html).
@@ -6,7 +6,7 @@ Satu pertanyaan, satu jawaban: **mode mana untuk tujuan saya?**
6
6
 
7
7
  | Saya ingin… | Gunakan | Karena |
8
8
  |---|---|---|
9
- |Memahami repo tanpa mengubah apa pun | `readonly` (atau `--tool-scope explore`) | Hanya 18 tool baca yang lolos; tulis/bash/commit/deligasi ditolak di gerbang |
9
+ |Memahami repo tanpa mengubah apa pun | `readonly` (atau `--tool-scope explore`) | Gerbang izin mengizinkan 18 tool baca (`READONLY_TOOLS`); model tetap hanya **melihat 12** tool baca (visibilitas `EXPLORE_TOOL_NAMES`) — tulis/bash/commit/delegasi ditolak di gerbang |
10
10
  | Minta agen membuat perubahan | `auto` (default) | Tulis terjail + bash aman langsung jalan; yang berisiko (commit, MCP, delegasi) tetap minta izin sekali |
11
11
  | Menyetujui setiap perubahan | `ask` | Tiap tool non-sepele menunggu jawaban; `todo`/`bash_output` tak ditanya (bookkeeping sendiri) |
12
12
  | Menyusun rencana tanpa eksekusi | `plan` | Baca + tulis rencana (`todo_write`) + delegasi yang dipaksa read-only; tanpa mutasi file/git/memori |
@@ -25,7 +25,7 @@ Satu pertanyaan, satu jawaban: **mode mana untuk tujuan saya?**
25
25
 
26
26
  - Semakin otonom → semakin cepat, semakin besar blast radius bila model salah paham. Tidak ada mode yang membuat model lebih bijak — mode hanya mengatur **apa yang boleh terjadi**.
27
27
  - `allowlist` (otomatis saat tanpa sandbox OS) paling ketat untuk shell, tetapi model tetap bisa menulis file via tool terjail — pahami beda sumbunya: allowlist membatasi *perintah*, jail membatasi *file*.
28
- - Ganti mode kapan pun: flag saat start, `/mode` atau Shift+Tab saat REPL berjalan.
28
+ - Ganti mode kapan pun: flag saat start, `/mode` atau Shift+Tab saat TUI berjalan.
29
29
 
30
30
  ## Lanjut
31
31