minicode-ai 0.23.0 → 0.26.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 (104) hide show
  1. package/README.md +5 -3
  2. package/cli/commands/config.ts +123 -0
  3. package/cli/setup.ts +107 -8
  4. package/cli/tui.ts +28 -2
  5. package/docs/README.md +2 -2
  6. package/docs/SUMMARY.md +10 -19
  7. package/docs/TERMINAL_CONTRACT.md +113 -28
  8. package/docs/architecture.md +1 -1
  9. package/docs/autonomous-scheduler.md +283 -2
  10. package/docs/choosing-mode.md +4 -4
  11. package/docs/concepts.md +39 -3
  12. package/docs/config.md +103 -5
  13. package/docs/environment.md +4 -0
  14. package/docs/getting-started.md +69 -5
  15. package/docs/repl.md +1 -1
  16. package/docs/security.md +49 -2
  17. package/docs/tools.md +2 -1
  18. package/package.json +2 -36
  19. package/src/app/provider-layer.ts +1 -1
  20. package/src/app/session.ts +187 -17
  21. package/src/config.ts +21 -8
  22. package/src/constants.ts +17 -1
  23. package/src/lib/net.ts +6 -15
  24. package/src/lib/public-http.ts +128 -0
  25. package/src/lib/safe-open.ts +21 -12
  26. package/src/memory/vector.ts +0 -31
  27. package/src/policy/auto-resume.ts +63 -0
  28. package/src/policy/compaction.ts +354 -70
  29. package/src/policy/context-budget.ts +4 -6
  30. package/src/policy/context-window-assign.ts +114 -0
  31. package/src/policy/context-window-catalog.ts +4 -1
  32. package/src/policy/context-window-presets.ts +165 -0
  33. package/src/policy/context-window.ts +19 -37
  34. package/src/policy/context.ts +11 -9
  35. package/src/policy/executor.ts +69 -27
  36. package/src/policy/microcompact.ts +76 -15
  37. package/src/policy/no-progress.ts +1 -1
  38. package/src/policy/permission.ts +5 -0
  39. package/src/policy/recovery-budget.ts +281 -0
  40. package/src/policy/scrub.ts +15 -2
  41. package/src/policy/step-escalation.ts +82 -0
  42. package/src/policy/tokenizer-registry.ts +1 -0
  43. package/src/policy/tool-contract.ts +11 -9
  44. package/src/presentation/reducer.ts +1 -0
  45. package/src/providers/anthropic.ts +3 -3
  46. package/src/providers/detect.ts +40 -7
  47. package/src/providers/provision.ts +23 -1
  48. package/src/runtime/child-execution.ts +4 -2
  49. package/src/runtime/execution-backend.ts +3 -0
  50. package/src/sandbox/os.ts +53 -9
  51. package/src/session/context-assembly.ts +11 -7
  52. package/src/session/persistence.ts +19 -3
  53. package/src/task/autonomous-policy.ts +7 -0
  54. package/src/task/graph-validate.ts +1 -1
  55. package/src/task/session-authority.ts +0 -5
  56. package/src/task/store.ts +0 -4
  57. package/src/tools/ask_user.ts +14 -1
  58. package/src/tools/bash.ts +68 -17
  59. package/src/tools/code_run.ts +19 -20
  60. package/src/tools/context.ts +10 -0
  61. package/src/tools/delete_file.ts +3 -2
  62. package/src/tools/edit.ts +5 -4
  63. package/src/tools/git.ts +70 -12
  64. package/src/tools/glob.ts +13 -5
  65. package/src/tools/grep.ts +26 -10
  66. package/src/tools/index.ts +3 -2
  67. package/src/tools/lsp.ts +15 -9
  68. package/src/tools/move_file.ts +4 -3
  69. package/src/tools/patch.ts +5 -4
  70. package/src/tools/read_file.ts +3 -2
  71. package/src/tools/read_image.ts +3 -2
  72. package/src/tools/task.ts +5 -1
  73. package/src/tools/todo.ts +4 -8
  74. package/src/tools/web_fetch.ts +13 -19
  75. package/src/tools/write_file.ts +4 -3
  76. package/src/ui/approval/prompt.ts +226 -77
  77. package/src/ui/assistant/simple.ts +61 -10
  78. package/src/ui/footer.ts +41 -29
  79. package/src/ui/i18n/en.ts +7 -0
  80. package/src/ui/i18n/id.ts +7 -0
  81. package/src/ui/input/prompt-engine.ts +53 -21
  82. package/src/ui/render/activity-group.ts +9 -0
  83. package/src/ui/render/activity-panel.ts +20 -2
  84. package/src/ui/render/ledger.ts +1 -9
  85. package/src/ui/render/logo.ts +0 -5
  86. package/src/ui/render/markdown-table.ts +0 -3
  87. package/src/ui/render/table-grid.ts +0 -3
  88. package/src/ui/render/theme.ts +31 -5
  89. package/src/ui/runtime/screen.ts +7 -1
  90. package/src/ui/screens/dialog.ts +45 -81
  91. package/src/ui/screens/form.ts +10 -10
  92. package/src/ui/screens/model-manager.ts +7 -10
  93. package/src/ui/screens/picker.ts +8 -11
  94. package/src/ui/screens/provider-manager.ts +9 -13
  95. package/src/ui/tui/app.ts +118 -20
  96. package/src/ui/tui/transcript.ts +179 -29
  97. package/vendor/minicore/src/core/loop.ts +20 -1
  98. package/vendor/minicore/src/core/session.ts +6 -0
  99. package/docs/P14_OPEN_WORK.md +0 -290
  100. package/docs/config-providers.md +0 -87
  101. package/docs/glossary.md +0 -39
  102. package/docs/quickstart.md +0 -60
  103. package/docs/security-model.md +0 -96
  104. package/docs/terminal.md +0 -91
package/docs/terminal.md DELETED
@@ -1,91 +0,0 @@
1
- # Kontrak Terminal
2
-
3
-
4
- Kontrak ini **FROZEN**: setiap perubahan perilaku terminal wajib update dokumen
5
- ini + test peta proteksinya. Versi lengkap (kontrak internal kontributor, peta
6
- proteksi per invariant, residual risk yang disengaja) ada di
7
- [Terminal Contract](TERMINAL_CONTRACT.md).
8
-
9
- ## Satu tampilan interaktif: TUI fullscreen
10
-
11
- Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **alternate
12
- screen**: transkrip ala shell + status bar satu baris + popup komposit di atas
13
- transkrip yang tetap terlihat (redup). REPL linier, footer lengket (chrome
14
- scroll-region), overlay inline, dan jendela info **DIHAPUS** — tak ada mode,
15
- tak ada flag legacy (`--tui` usang = no-op). Keluar = buffer utama kembali
16
- persis; transkrip sesi tidak di-dump ke scrollback.
17
-
18
- Jalur **non-interaktif** (one-shot prompt, `exec`, pipe/redirect/CI,
19
- `TERM=dumb`, layar < 10 baris) tetap shell-first: cetak polos, append-only ke
20
- scrollback, tanpa alternate screen. Justru jalur inilah yang membuat hasil agen
21
- bisa di-pipe, di-grep, dan tinggal di scrollback Anda sendiri.
22
-
23
- ## Dua stream, dua isi
24
-
25
- | Stream | Isi |
26
- |---|---|
27
- | stdout | Output program: teks model (wrapped, fence 2-spasi; pipe-table menjadi grid selaras di TTY), receipt perubahan (`› write_file …`), artefak perintah. Bersih dari cursor-control saat non-TTY |
28
- | stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY — ditahan saat layar interaktif memegang terminal |
29
-
30
- - Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe.
31
- - Error `pesan actionable` (berwarna merah, tanpa ikon sejak v0.17.0) sekali per kegagalan (`takePendingError`) — bukan spam di setiap langkah.
32
-
33
- ## Primitif tampilan
34
-
35
- 1. Transkrip fullscreen — prompt `minicode ›` saat editing + jawaban model + ledger, viewport ikut ekor otomatis; drag mouse membuat selection app-level, `Ctrl+C` menyalin, wheel dan `PgUp/PgDn` menggulir layar
36
- 2. Status bar satu baris — `✦ 00.00.00 mode model cwd` (timer `HH.MM.SS` di sebelah sparkle; redup idle, detik putih saat aktif, menit mulai terang di 60 dtk, jam di 1 jam; tanpa bullet separator; konteks rata kanan)
37
- 3. Popup komposit satu kotak — `/model`, `/provider`, `/sessions`, form, approval; Esc dua-tahap, kursor diparkir
38
- 4. Ledger — ` › name target` hijau / ` › name: …` merah
39
- 5. Teks model & thinking — mengalir redup (thinking), di-buffer untuk `/expand`
40
- 6. Error actionable — sekali per kegagalan
41
-
42
- ## Arbitrasi transient + hold layar interaktif
43
-
44
- Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts`
45
- (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs
46
- spinner wizard) mutually exclusive; overlap = signal `[transient-paint]`, bukan
47
- crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya
48
- sebagai baris permanen bersih.
49
-
50
- `beginInteractiveScreen()` menahan SEMUA painter transient selama layar
51
- interaktif memegang terminal (nol byte + baris painter dibersihkan sekali;
52
- nested + release idempoten). Pemegangnya: `askLine`/`askSecret`/`runPicker`
53
- (raw-mode) dan setiap handle `openAltScreen` (dilepas di `close()`). Tanpa ini
54
- tick `\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
55
- Menyiapkan sesi…").
56
-
57
- Karena `screen.paint` kini mendiff secara inkremental, tulis ASING ke stderr
58
- selama alt-screen hidup (mis. `[hooks] skipped …`, warning provider) juga
59
- menandai terminal "kotor" — `statusline.consumeScreenDrift()` yang dikonsumsi
60
- layar untuk memaksa repaint penuh sekali pada paint berikutnya. `beginInteractiveScreen`
61
- memasang wrapper stderr pada depth 0→1 supaya sinyal ini aktif bahkan tanpa
62
- owner transient. Tanpa ini fragmen asing tetap menempel di baris yang kebetulan
63
- tak berubah.
64
-
65
- ## Invariant I1–I35
66
-
67
- Peta lengkap 35 invariant + test proteksinya (mis. `tui-app`, `screen-buffer`,
68
- `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`) ada di
69
- [Terminal Contract](TERMINAL_CONTRACT.md). Setiap fitur terminal baru tunduk
70
- pada invariant itu — mis. tak boleh menulis cursor-control ke stdout non-TTY,
71
- tak boleh mengandalkan alternate screen di jalur non-interaktif.
72
-
73
- Kontrak versi **v7.12** (2026-11-10) juga mencantumkan **peta gap proteksi**:
74
- klaim yang implementasinya benar tetapi belum punya assertion penjaga. Baca
75
- saga itu sebelum menyatakan "sudah dijaga".
76
-
77
- ## Aksesibilitas & konsol lawas
78
-
79
- `MINICODE_ASCII=1` (glyph `[OK]`/`>`/`.`), `MINICODE_A11Y=1` (live-region approval polos tanpa ANSI), `MINICODE_BELL=0`, `MINICODE_DROPDOWN=0` (hint inline), `MINICODE_MOTION=0` (spark statis, tanpa pulse). Daftar lengkap di [Environment Variables](environment.md).
80
-
81
- ### Sinyal fatal & pemulihan terminal
82
-
83
- Sesi TUI memasang handler SIGTERM/SIGHUP sendiri selama hidup (dilepas saat
84
- quit): sinyal = raw mode dimatikan + alt-screen ditutup + exit `128+n`
85
- (SIGTERM=143, SIGHUP=129) — terminal tidak tertinggal di buffer alt. `kill -9`
86
- tetap di luar jangkauan (ketik `reset`; residual kontrak #2).
87
-
88
- ## Lanjut
89
-
90
- - [Konsep & Desain](concepts.md) — kenapa interaktif pakai alt-screen, non-interaktif shell-first.
91
- - [TUI — Slash & Keyboard](repl.md) — interaksi harian di atas kontrak ini.