minicode-ai 0.23.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/tui.ts +28 -2
- package/docs/README.md +2 -2
- package/docs/SUMMARY.md +10 -19
- package/docs/TERMINAL_CONTRACT.md +82 -28
- 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 +3 -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/config.ts +2 -0
- package/src/constants.ts +3 -0
- package/src/lib/safe-open.ts +21 -12
- package/src/memory/vector.ts +0 -31
- package/src/policy/context-window.ts +0 -33
- 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 +3 -3
- package/src/providers/detect.ts +27 -0
- package/src/providers/provision.ts +15 -1
- 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/footer.ts +41 -29
- package/src/ui/i18n/en.ts +4 -0
- package/src/ui/i18n/id.ts +4 -0
- package/src/ui/render/activity-group.ts +1 -0
- package/src/ui/render/ledger.ts +1 -9
- package/src/ui/render/logo.ts +0 -5
- package/src/ui/render/markdown-table.ts +0 -3
- package/src/ui/render/table-grid.ts +0 -3
- package/src/ui/render/theme.ts +31 -5
- package/src/ui/runtime/screen.ts +7 -1
- package/src/ui/screens/dialog.ts +45 -81
- package/src/ui/screens/form.ts +10 -10
- package/src/ui/screens/model-manager.ts +7 -10
- package/src/ui/screens/picker.ts +8 -11
- package/src/ui/screens/provider-manager.ts +9 -13
- package/src/ui/tui/app.ts +92 -9
- package/src/ui/tui/transcript.ts +4 -0
- 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
package/README.md
CHANGED
|
@@ -39,9 +39,9 @@ WorkMode controls how the agent works (`DISCUSS`, `PLAN`, or `BUILD`); permissio
|
|
|
39
39
|
The full manual lives in [`docs/`](docs/) and is rendered at [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). Quick links:
|
|
40
40
|
|
|
41
41
|
- [Documentation index](docs/README.md) and [full navigation](docs/SUMMARY.md)
|
|
42
|
-
- [Installation](docs/getting-started.md) · [Quickstart](docs/
|
|
42
|
+
- [Installation](docs/getting-started.md) · [Quickstart](docs/getting-started.md) · [CLI](docs/cli.md) · [TUI](docs/repl.md)
|
|
43
43
|
- [Configuration and providers](docs/config.md) · [Environment variables](docs/environment.md) · [Tools](docs/tools.md)
|
|
44
|
-
- [Security model](docs/security
|
|
44
|
+
- [Security model](docs/security.md) · [Policy and sandbox](docs/policy-sandbox.md)
|
|
45
45
|
- [Architecture and repository map](docs/architecture.md)
|
|
46
46
|
- [Contributing](docs/contributing.md) · [Release history](https://github.com/minilabs-id/minicode/releases)
|
|
47
47
|
|
package/cli/tui.ts
CHANGED
|
@@ -26,6 +26,7 @@ import {
|
|
|
26
26
|
} from "../src/presentation/projection.ts"
|
|
27
27
|
import { redoLastCheckpoint, undoLastCheckpoint } from "../src/session/checkpoint.ts"
|
|
28
28
|
import { renderSkill } from "../src/skills/loader.ts"
|
|
29
|
+
import { listBackgroundJobs, onBackgroundJobFinished } from "../src/tools/bash.ts"
|
|
29
30
|
import {
|
|
30
31
|
clipboardByteLength,
|
|
31
32
|
MAX_CLIPBOARD_BYTES,
|
|
@@ -193,6 +194,9 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
193
194
|
ui.setMinimizeActivity(true)
|
|
194
195
|
let warned80 = false
|
|
195
196
|
let abort: AbortController | null = null
|
|
197
|
+
/** Job background hidup (badge footer). Dihitung dari registry tool bash. */
|
|
198
|
+
const countLiveBackgroundJobs = (): number =>
|
|
199
|
+
listBackgroundJobs().reduce((n, j) => (j.done ? n : n + 1), 0)
|
|
196
200
|
|
|
197
201
|
// Fase 1 perf (butir 2b): `session.contextTokens` adalah getter O(history)
|
|
198
202
|
// (estimateMessages mengiterasi SELURUH store + estimator per pesan). Footer
|
|
@@ -629,7 +633,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
629
633
|
// WorkMode EXECUTE (BUILD) agar ceiling DISCUSS/PLAN tak menahan tulis.
|
|
630
634
|
workModeControl?.setWorkMode("EXECUTE")
|
|
631
635
|
app.repaint()
|
|
632
|
-
transcript.pushInfo([c.warning(`${glyphs.unlock} ${t("tui.unrestrictedOn")}`)])
|
|
636
|
+
transcript.pushInfo([c.warning(`${c.red(glyphs.unlock)} ${t("tui.unrestrictedOn")}`)])
|
|
633
637
|
return
|
|
634
638
|
}
|
|
635
639
|
mode = modeBeforeUnrestricted ?? "auto"
|
|
@@ -643,7 +647,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
643
647
|
modeBeforeUnrestricted = null
|
|
644
648
|
workModeBeforeUnrestricted = null
|
|
645
649
|
app.repaint()
|
|
646
|
-
transcript.pushInfo([c.muted(`${glyphs.
|
|
650
|
+
transcript.pushInfo([c.muted(`${glyphs.lock} ${t("tui.unrestrictedOff", { m: mode })}`)])
|
|
647
651
|
return
|
|
648
652
|
}
|
|
649
653
|
if (name === "lang") {
|
|
@@ -812,6 +816,9 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
812
816
|
cwd: cwd ?? process.cwd(),
|
|
813
817
|
context: fmtCtx(getContextTokens()),
|
|
814
818
|
metrics: fmtUsageMetrics(ctx, getContextTokens()),
|
|
819
|
+
// Jumlah job background hidup — dihitung di sini karena badge footer
|
|
820
|
+
// adalah view murni (src/ui dilarang impor src/ non-UI).
|
|
821
|
+
backgroundJobs: countLiveBackgroundJobs(),
|
|
815
822
|
},
|
|
816
823
|
busy,
|
|
817
824
|
}
|
|
@@ -853,12 +860,30 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
853
860
|
// Approval sebagai warga TUI: blok pertanyaan + keputusan tercatat di
|
|
854
861
|
// transkrip dan terlihat sebelum menjawab (tanpa sink = tulis langsung).
|
|
855
862
|
const { setApprovalSink } = await import("../src/ui/tui/transcript.ts")
|
|
863
|
+
// Auto-resume sekali per job background (scope "lanjutkan tanpa saya"),
|
|
864
|
+
// bounded: satu resume per id, tak menumpuk walau banyak job selesai.
|
|
865
|
+
const resumedJobs = new Set<string>()
|
|
866
|
+
const autoResumeEnabled = process.env.MINICODE_AUTORESUME_BG !== "0"
|
|
867
|
+
const unsubscribeJobFinished = onBackgroundJobFinished((id, code) => {
|
|
868
|
+
try {
|
|
869
|
+
if (resumedJobs.has(id)) return
|
|
870
|
+
resumedJobs.add(id)
|
|
871
|
+
app.repaint()
|
|
872
|
+
if (!autoResumeEnabled) return
|
|
873
|
+
// Abort-aware: jangan menyela turn berjalan atau memulai saat quitting.
|
|
874
|
+
transcript.pushInfo([c.muted(t("tui.bgFinished", { id, code: code ?? "?" }))])
|
|
875
|
+
if (abort !== null) return
|
|
876
|
+
void runTurn(t("tui.bgFinishedAuto", { id, code: code ?? "?" })).catch(() => {})
|
|
877
|
+
} catch {}
|
|
878
|
+
})
|
|
856
879
|
try {
|
|
857
880
|
setApprovalSink({
|
|
858
881
|
pushBlock: (lines) => transcript.pushInfo(lines),
|
|
859
882
|
repaint: () => app.repaint(),
|
|
860
883
|
suspend: () => app.suspend(),
|
|
861
884
|
resume: () => app.resume(),
|
|
885
|
+
paintRegion: (lines, topRow) => app.paintRegion(lines, topRow),
|
|
886
|
+
clearRegion: () => app.clearRegion(),
|
|
862
887
|
})
|
|
863
888
|
const res = await app.run()
|
|
864
889
|
if (!res.started) {
|
|
@@ -874,6 +899,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
874
899
|
}
|
|
875
900
|
} finally {
|
|
876
901
|
setApprovalSink(null)
|
|
902
|
+
unsubscribeJobFinished()
|
|
877
903
|
for (const unsub of liveContextUnsubs.splice(0)) {
|
|
878
904
|
try {
|
|
879
905
|
unsub()
|
package/docs/README.md
CHANGED
|
@@ -5,7 +5,7 @@ MiniCode adalah coding agent terminal yang dibangun di atas kernel MiniCore. Jal
|
|
|
5
5
|
## Mulai
|
|
6
6
|
|
|
7
7
|
1. Ikuti [instalasi](getting-started.md). Metadata paket dan batas runtime Bun tersedia di `package.json` pada root repository.
|
|
8
|
-
2. Gunakan [quickstart](
|
|
8
|
+
2. Gunakan [quickstart](getting-started.md) untuk menyiapkan provider dan menjalankan prompt pertama.
|
|
9
9
|
3. Baca [memilih mode](choosing-mode.md) sebelum memberi agent akses tulis atau eksekusi.
|
|
10
10
|
|
|
11
11
|
## Batas yang perlu diketahui
|
|
@@ -16,7 +16,7 @@ MiniCode adalah coding agent terminal yang dibangun di atas kernel MiniCore. Jal
|
|
|
16
16
|
|
|
17
17
|
## Peta dokumentasi
|
|
18
18
|
|
|
19
|
-
`SUMMARY.md` adalah daftar navigasi; dibaca build minilabs untuk membangun indeks halaman. Versi terbit tersedia di [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). [Arsitektur](architecture.md) memuat peta struktur dan alur runtime.
|
|
19
|
+
`SUMMARY.md` adalah daftar navigasi; dibaca build minilabs untuk membangun indeks halaman. Jumlah halaman dijaga kecil dan bebas duplikasi — satu topik, satu halaman. Versi terbit tersedia di [minilabs.id/projects/minicode/docs](https://minilabs.id/projects/minicode/docs/). [Arsitektur](architecture.md) memuat peta struktur dan alur runtime.
|
|
20
20
|
|
|
21
21
|
## Pengembangan
|
|
22
22
|
|
package/docs/SUMMARY.md
CHANGED
|
@@ -4,11 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
## Memulai
|
|
6
6
|
|
|
7
|
-
* [Instalasi](getting-started.md)
|
|
8
|
-
* [
|
|
9
|
-
* [Konsep & Desain](concepts.md)
|
|
7
|
+
* [Instalasi & Quickstart](getting-started.md)
|
|
8
|
+
* [Konsep, Desain & Glosarium](concepts.md)
|
|
10
9
|
* [Memilih Mode](choosing-mode.md)
|
|
11
|
-
* [Glosarium](glossary.md)
|
|
12
10
|
|
|
13
11
|
## Menggunakan
|
|
14
12
|
|
|
@@ -18,7 +16,7 @@
|
|
|
18
16
|
* [Skills & Hooks](skills.md)
|
|
19
17
|
* [Pricing & Budget](pricing-budget.md)
|
|
20
18
|
|
|
21
|
-
## Kemampuan
|
|
19
|
+
## Kemampuan
|
|
22
20
|
|
|
23
21
|
* [Tools](tools.md)
|
|
24
22
|
* [Sub-Agents & Tasks](agents.md)
|
|
@@ -26,8 +24,7 @@
|
|
|
26
24
|
|
|
27
25
|
## Konfigurasi
|
|
28
26
|
|
|
29
|
-
* [Config
|
|
30
|
-
* [Config & Provider](config-providers.md)
|
|
27
|
+
* [Config & Provider](config.md)
|
|
31
28
|
* [Environment Variables](environment.md)
|
|
32
29
|
|
|
33
30
|
## State & Memori
|
|
@@ -37,31 +34,25 @@
|
|
|
37
34
|
|
|
38
35
|
## Keamanan
|
|
39
36
|
|
|
40
|
-
* [
|
|
41
|
-
* [Policy & Sandbox](policy-sandbox.md)
|
|
42
|
-
* [Keamanan](security.md) — mekanisme & bukti pengukuran
|
|
43
|
-
|
|
44
|
-
## Bantuan
|
|
45
|
-
|
|
46
|
-
* [Troubleshooting](troubleshooting.md)
|
|
37
|
+
* [Keamanan — mode ancaman & bukti](security.md)
|
|
38
|
+
* [Policy & Sandbox](policy-sandbox.md)
|
|
47
39
|
|
|
48
40
|
## Eksperimental
|
|
49
41
|
|
|
50
|
-
* [Autonomous Scheduler](autonomous-scheduler.md)
|
|
51
|
-
* [Open Work — Lintas Sesi](P14_OPEN_WORK.md)
|
|
42
|
+
* [Autonomous Scheduler & Open Work](autonomous-scheduler.md)
|
|
52
43
|
|
|
53
44
|
## Kontributor & Arsitektur
|
|
54
45
|
|
|
55
46
|
* [Arsitektur & Peta Repository](architecture.md)
|
|
56
|
-
* [Kontrak Terminal (ringkas)](terminal.md)
|
|
57
47
|
* [Contributing](contributing.md)
|
|
48
|
+
* [Troubleshooting](troubleshooting.md)
|
|
58
49
|
|
|
59
50
|
## Spesifikasi internal (FROZEN — untuk kontributor)
|
|
60
51
|
|
|
61
|
-
* [Terminal Contract
|
|
52
|
+
* [Terminal Contract](TERMINAL_CONTRACT.md)
|
|
62
53
|
* [Output Event Model](OUTPUT_EVENT_MODEL.md)
|
|
63
54
|
* [Output Protocol Spec](OUTPUT_PROTOCOL_SPEC.md)
|
|
64
55
|
* [Output Rendering Spec](OUTPUT_RENDERING_SPEC.md)
|
|
65
56
|
* [Output UX Rules](OUTPUT_UX_RULES.md)
|
|
66
57
|
* [Control Plane Map](CONTROL-PLANE-MAP.md)
|
|
67
|
-
* [UI Render Pipeline](UI_RENDER_PIPELINE.md)
|
|
58
|
+
* [UI Render Pipeline](UI_RENDER_PIPELINE.md)
|
|
@@ -1,4 +1,35 @@
|
|
|
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`).
|
|
2
33
|
|
|
3
34
|
Perubahan v7.13: baris status kompaksi (`context:compacted`) kini **membedakan
|
|
4
35
|
hasil** alih-alih mencetak `reason` mentah. Sebelumnya sesi yang konteksnya TIDAK
|
|
@@ -36,8 +67,10 @@ wrap (bukan truncate ellipsis). Tabel markdown tetap kotak ber-garis + wrap
|
|
|
36
67
|
(v7.10). Thinking di renderer linear ikut di-indent 2 kolom, konsisten dengan TUI.
|
|
37
68
|
|
|
38
69
|
Perubahan v7.10: pembatas bash allow-list (fallback "no-sandbox") ditampilkan
|
|
39
|
-
sebagai **
|
|
40
|
-
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
|
|
41
74
|
tetap Auto/Ask; nilai Permission Mode untuk `--allow-all` sengaja ditampilkan
|
|
42
75
|
sebagai `Auto` (auto ≈ allow-all: otonom penuh tanpa izin) — catatan desain,
|
|
43
76
|
bukan bug. Angka konteks footer memakai `session.contextTokens` — estimasi
|
|
@@ -57,9 +90,11 @@ command tanpa slash, judul, deskripsi, atau baris tambahan. Picker provider,
|
|
|
57
90
|
model, dan pilihan umum tidak memakai judul/footer; baris provider/model dibuat
|
|
58
91
|
ringkas.
|
|
59
92
|
|
|
60
|
-
Perubahan v7.7: footer
|
|
61
|
-
dan
|
|
62
|
-
|
|
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
|
|
63
98
|
mode atau konteks dihilangkan.
|
|
64
99
|
|
|
65
100
|
Perubahan v7.6: sinkronisasi kontrak WorkMode ke mode produk 0.14.1 — label
|
|
@@ -295,19 +330,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
295
330
|
live dibatasi 1.000.000 karakter dan menampilkan marker truncasi; satu
|
|
296
331
|
layout paint tidak boleh memproyeksikan transcript dua kali.
|
|
297
332
|
|
|
298
|
-
13. Status bar: 1 baris dasar (`✦ 00.00.00
|
|
299
|
-
|
|
333
|
+
13. Status bar: 1 baris dasar (`✦ 00.00.00 Discuss model cwd … context Auto`)
|
|
334
|
+
dari sumber yang sama dengan angka sesi.
|
|
300
335
|
Nilai `context` (dan `metrics` window %) saat turn AKTIF memakai occupancy
|
|
301
336
|
LIVE turn-store yang di-emit kernel per step (event `provider:extension`
|
|
302
337
|
kind `context-window`, setelah `step:completed`); saat idle kembali ke
|
|
303
338
|
`session.contextTokens` (committed store). Estimator tetap satu sumber —
|
|
304
339
|
hanya store yang dibaca berganti antara turn-store (tumbuh) vs committed
|
|
305
340
|
(beku), tak ada duplikasi angka sumber (v7.12).
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
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
|
|
311
348
|
menjadi indikator proses hidup;
|
|
312
349
|
timer `HH.MM.SS` berada tepat di sebelahnya. Idle=redup; saat aktif hanya
|
|
313
350
|
detik putih, menit ikut terang setelah 60 dtk, dan jam setelah 1 jam.
|
|
@@ -368,9 +405,18 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
368
405
|
berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
|
|
369
406
|
oldest-to-newest) melalui OSC 52.
|
|
370
407
|
19. Dropdown `/` inline berbingkai; Enter pada menu melengkapi + kirim.
|
|
371
|
-
20. Lebar kotak popup
|
|
372
|
-
|
|
373
|
-
|
|
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.
|
|
374
420
|
21. Form dalam popup: semua input teks/pilihan di dalam kotak (text/secret/
|
|
375
421
|
select/confirm + validasi inline + kursor diparkir); tak ada ketikan di
|
|
376
422
|
luar kotak. Esc dua-tahap: tekan-1 KEMBALIKAN nilai bawaan field
|
|
@@ -526,22 +572,24 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
526
572
|
ditahan pada WorkMode `DISCUSS`/`PLAN` dan PermissionMode warisan
|
|
527
573
|
`plan`/`readonly`; `Tab` mengubah WorkMode, sedangkan `Shift+Tab` mengubah
|
|
528
574
|
PermissionMode AUTO/ASK.
|
|
529
|
-
**Footer:** Work Mode tampil di kiri
|
|
530
|
-
`
|
|
531
|
-
|
|
532
|
-
`Permission Mode
|
|
533
|
-
warna semantik; nilai Permission Mode memakai cyan agar kedua sumbu
|
|
534
|
-
dibedakan.
|
|
535
|
-
|
|
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.
|
|
536
583
|
|
|
537
584
|
## Grammar (ringkas)
|
|
538
585
|
|
|
539
586
|
prompt `minicode ›` tampil saat boot/idle dan hilang saat busy (dropdown `/`
|
|
540
587
|
berbingkai di atasnya) ·
|
|
541
|
-
status bar `✦ 00.00.00
|
|
588
|
+
status bar `✦ 00.00.00 Discuss model cwd … context Auto ●`
|
|
542
589
|
(timer redup idle; detik putih aktif, menit mulai terang di 60 dtk, jam di 1
|
|
543
590
|
jam; tanpa bullet separator; permission rata kanan dekat token konteks; label
|
|
544
|
-
|
|
591
|
+
`Work Mode:`/`Permission Mode:` dihapus; `●` kuning = bash allow-list aktif,
|
|
592
|
+
abu = tidak, `○` merah = unrestricted; badge `◷ N` bila job background hidup)
|
|
545
593
|
+ satu spacer sebelum footer · ledger tool
|
|
546
594
|
` › name target` (hijau) / merah saat error · error `pesan` berwarna merah sekali per
|
|
547
595
|
kegagalan · pesan error TUI = formatter kanonik (`formatError`,
|
|
@@ -659,7 +707,8 @@ panjang).
|
|
|
659
707
|
pola mati dihapus, subset p15..p24 hadir di kedua job.
|
|
660
708
|
|
|
661
709
|
- `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
|
|
662
|
-
anti-hantu).
|
|
710
|
+
anti-hantu) + I13 (App.paintRegion/clearRegion mendelegasikan region modal ke
|
|
711
|
+
screen; clock badge memutar `◷` saat idle lalu berhenti saat quit).
|
|
663
712
|
- `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
|
|
664
713
|
Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
|
|
665
714
|
select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
|
|
@@ -677,8 +726,13 @@ panjang).
|
|
|
677
726
|
`sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
|
|
678
727
|
sekadar di-import tidak menulis byte ke alt-screen.
|
|
679
728
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
680
|
-
stdout-pipe tanpa sink = deny).
|
|
681
|
-
|
|
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]`).
|
|
682
736
|
- `test/e2e.test.ts` — I13 v7.12 (kernel meng-emit `provider:extension`
|
|
683
737
|
kind `context-window` berisi `usedTokens`/`windowTokens` setelah
|
|
684
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
|
|