agen-vektor 0.3.32 → 0.3.33

package/README.md

@@ -471,6 +471,11 @@ secrets stay private):
 
 ## Changelog
 
+### 0.3.33
+- **Boot splash "Loading System . . ." before the TUI dashboard.** Launching `vector` now shows a brief boot screen — brand banner, three loading steps (Config → Environment → Provider), a braille spinner and progress bar, then "System ready" — before the whole block is cleanly erased and the chat TUI enters alt-screen. Zero scrollback residue.
+- **Zero dependencies, Termux-safe.** The splash follows `VECTOR_ASCII` (spinner becomes `|/-\` in ASCII safe mode), never blocks process exit (timer is unref'd), and failure to build the agent still clears the splash before the error propagates.
+- **Controls:** `VECTOR_SPLASH=0` disables it entirely; `VECTOR_SPLASH_STEP_MS` (default 450) and `VECTOR_SPLASH_HOLD_MS` (default 900) tune the timing.
+
 ### 0.3.30
 - **Thinking card matches Freebuff `thinking.tsx` exactly — no mid-run color flip-flop.** The reasoning body renders muted (`#acb3bf`) italic in BOTH streaming and completed states; only the header (dot + bold "Thinking") is foreground-white. Previously the body flipped from white (streaming) to muted (done), which read as the card changing color during a run.
 - **Expanded thinking view is raw muted italic with word wrap.** The in-card markdown re-render was removed — headings/inline code no longer paint their own colors inside the card (the mixed-color expanded view read as noise). Markdown markers in reasoning now show as-is, uniformly styled.

package/dist/cli/index.js

@@ -22,6 +22,7 @@ const factory_1 = require("../providers/factory");
 const paths_1 = require("../utils/paths");
 const logger_1 = require("../utils/logger");
 const keyboard_1 = require("./keyboard");
+const splash_1 = require("./splash");
 const terminal_1 = require("../utils/terminal");
 /** Disable auto-wrap margins (DECAWM off): a full-width row then CANNOT
  *  push the cursor into the pending-wrap state, so the next write can never
@@ -248,7 +249,21 @@ async function runTui(opts) {
         await runNonInteractive(opts);
         return;
     }
-    const agent = await buildAgent(opts);
+    // Boot splash "Loading System . . ." (additive, 2026-09-16): tampil
+    // sebelum buildAgent/loading dashboard; VECTOR_SPLASH=0 mematikan.
+    const splash = await (0, splash_1.runSplash)();
+    let agent;
+    try {
+        await splash.step('config dimuat');
+        agent = await buildAgent(opts);
+        await splash.step('environment siap');
+        await splash.step(`provider ${opts.provider || agent.config.provider}`);
+        await splash.finish();
+    }
+    catch (err) {
+        await splash.finish();
+        throw err;
+    }
     const config = agent.config;
     // OpenCode-style theming: --theme wins, then VECTOR_THEME (already folded
     // into config via effectiveConfig inside the Agent), then config.json.

package/dist/cli/splash.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splashEnabled = splashEnabled;
+exports.runSplash = runSplash;
+/**
+ * Boot splash — "Loading System . . ." (2026-09-16).
+ *
+ * Additive fitur: ditampilkan HANYA di runTui (interactive TTY) sebelum
+ * dashboard chat TUI masuk alt-screen. Tidak menyentuh agent, provider,
+ * maupun TUI — murni penggambar ANSI di buffer utama lalu DIHAPUS BERSIH
+ * sebelum TUI mulai (tidak meninggalkan sampah scrollback).
+ *
+ * Zero dependency: hanya ANSI escape dari utils/terminal. ASCII safe mode
+ * (VECTOR_ASCII=1) otomatis: spinner & simbol di-ganti varian 1 kolom via
+ * toAsciiSafe agar tidak merobek layout di Termux/font CJK.
+ *
+ * Skip: VECTOR_SPLASH=0 mematikan splash sepenuhnya (zero delay) — cocok
+ * untuk skrip/otomasi. Step delay bisa diatur VECTOR_SPLASH_STEP_MS.
+ */
+const terminal_1 = require("../utils/terminal");
+/** Spinner frames — braille di mode normal, 1-kolom ASCII di ASCII mode. */
+const SPINNER_BRAILLE = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SPINNER_ASCII = ['|', '/', '-', '\\'];
+/** Warna brand (independen dari THEME — theme di-apply SETELAH buildAgent). */
+const ORANGE = '\x1b[38;2;255;133;52m'; // #FF8534 — aksen VectorHead
+const GREEN = '\x1b[38;2;159;252;98m'; // #9EFC62 — sukses VectorHead
+const WHITE = '\x1b[97m';
+const DIM = terminal_1.ANSI.dim;
+const RESET = terminal_1.ANSI.reset;
+/** Jeda per step agar urutan loading terasa (bisa di-override untuk test). */
+const STEP_DELAY_MS = Math.max(0, Number(process.env.VECTOR_SPLASH_STEP_MS ?? 450));
+/** Jeda "System ready" sebelum blok dihapus. */
+const FINISH_HOLD_MS = Math.max(0, Number(process.env.VECTOR_SPLASH_HOLD_MS ?? 900));
+/** Lebar progress bar (kolom). */
+const BAR_WIDTH = 22;
+/** Splash aktif? VECTOR_SPLASH=0 mematikan (env menang, default ON). */
+function splashEnabled() {
+    const v = process.env['VECTOR_SPLASH'];
+    if (v === undefined)
+        return true;
+    return v !== '0' && v.toLowerCase() !== 'false';
+}
+/** Panjang terlihat (kolom) dari string ber-ANSI milik splash sendiri. */
+function visibleLen(painted) {
+    return painted.replace(/\x1b\[[0-9;]*[A-Za-z]/g, '').length;
+}
+/** Bar progress "███░░░░░ 45%" — satu kolom per glyph di kedua mode. */
+function bar(fraction) {
+    const pct = Math.max(0, Math.min(1, fraction));
+    const filled = Math.round(BAR_WIDTH * pct);
+    return (GREEN + '█'.repeat(filled) + DIM + '░'.repeat(BAR_WIDTH - filled) + RESET +
+        ` ${Math.round(pct * 100)}%`);
+}
+/**
+ * Jalankan splash: banner sekali + spinner live row. Panggil `step()` per
+ * progress, akhiri dengan `finish()` (WAJIB — mengembalikan kursor).
+ * Menangani sendiri kasus lebar terminal ekstrim (kolom < 24 → bar disembunyikan).
+ */
+async function runSplash() {
+    if (!splashEnabled()) {
+        // No-op handle: kode pemanggil tetap bisa memanggil step()/finish().
+        return { step: async () => { }, finish: async () => { } };
+    }
+    const out = process.stdout;
+    const cols = Math.max(1, (0, terminal_1.getTerminalSize)().cols);
+    const ascii = terminal_1.toAsciiSafe; // ASCII safe mode mengikuti VECTOR_ASCII/Termux
+    const frames = asciiModeFrames();
+    const showBar = cols >= BAR_WIDTH + 30;
+    // Pusatkan satu baris (diukur dari versi TERPAINT agar ASCII map ikut dihitung).
+    const center = (text) => {
+        const painted = ascii(text);
+        const pad = Math.max(0, Math.floor((cols - visibleLen(painted)) / 2));
+        return ' '.repeat(pad) + text;
+    };
+    const lines = []; // jumlah baris yang sudah digambar (untuk clear di finish)
+    const write = (s) => {
+        out.write(ascii(s));
+    };
+    const paintLine = (s) => {
+        lines.push(s);
+        write(center(s) + '\r\n');
+    };
+    out.write(terminal_1.ANSI.hideCursor);
+    // ── Banner (sekali) ──────────────────────────────────────────────
+    paintLine(`${ORANGE}▮${RESET} ${WHITE}VectorHead${RESET} ${DIM}v${version()}${RESET}`);
+    paintLine(`${DIM}Initializing system components . . .${RESET}`);
+    paintLine('');
+    // ── Live row (spinner + label + bar) — di-rewrite di tempat ──────
+    let frame = 0;
+    let stepIndex = 0;
+    let label = 'Loading System';
+    const renderLive = () => {
+        const glyph = frames[frame % frames.length];
+        frame++;
+        const pct = Math.min(0.92, 0.15 + stepIndex * 0.22);
+        const text = `${GREEN}${glyph}${RESET} ${WHITE}${label}${RESET} ${DIM}.${RESET}${DIM}.${RESET}${DIM}.${RESET}` +
+            (showBar ? `   ${bar(pct)}` : '');
+        // Rewrite in place: kembali ke awal baris live lalu gambar ulang.
+        write('\r' + terminal_1.ANSI.clearLineEnd + center(text));
+    };
+    const liveTimer = setInterval(renderLive, 90);
+    // Timer TIDAK boleh menahan proses kalau splash ternyata tidak di-finish
+    // (crash path) — biarkan Node berhemi natural.
+    if (typeof liveTimer.unref === 'function')
+        liveTimer.unref();
+    renderLive();
+    await sleep(420); // momen awal "Loading System . . ." terlihat jelas
+    const names = ['Config', 'Environment', 'Provider'];
+    return {
+        async step(detail) {
+            const name = names[Math.min(stepIndex, names.length - 1)];
+            stepIndex++;
+            // Ganti live row dengan baris step selesai (append permanen).
+            const mark = ascii('✓') === '✓' ? '✓' : 'ok';
+            const check = `${GREEN}${mark}${RESET}`;
+            const info = detail ? `  ${DIM}${detail}${RESET}` : '';
+            write('\r' + terminal_1.ANSI.clearLineEnd); // hapus live row
+            paintLine(`${check} ${WHITE}${name}${RESET}${info}`);
+            label = `Loading ${names[Math.min(stepIndex, names.length - 1)] ?? 'System'}`;
+            renderLive();
+            await sleep(STEP_DELAY_MS);
+        },
+        async finish() {
+            clearInterval(liveTimer);
+            const mark = ascii('✓') === '✓' ? '✓' : 'ok';
+            write('\r' + terminal_1.ANSI.clearLineEnd);
+            paintLine(`${GREEN}${mark}${RESET} ${WHITE}System ready${RESET}`);
+            write(`\r\n${DIM}Starting VectorHead TUI . . .${RESET}`);
+            lines.push('', '');
+            await sleep(FINISH_HOLD_MS);
+            // Hapus seluruh blok splash → terminal bersih sebelum alt-screen TUI.
+            // Kursor berada DI baris terakhir (Starting…) → clearLine dulu, lalu
+            // naik + clear per baris tergambar (banner s.d. baris kosong terakhir).
+            let clear = terminal_1.ANSI.clearLine;
+            for (let i = 0; i < lines.length; i++)
+                clear += terminal_1.ANSI.cursorUp(1) + terminal_1.ANSI.clearLine;
+            out.write('\r' + clear);
+            out.write(terminal_1.ANSI.showCursor);
+        },
+    };
+}
+function asciiModeFrames() {
+    // toAsciiSafe memetakan braille → '*' (3 kolom? tidak — catchall 1 kolom),
+    // tapi spinner jadi tidak enak dilihat; varian ASCII asli lebih rapi.
+    try {
+        // Impur dinamis dihindari; cukup cek env yang sama dengan asciiModeEnabled.
+        const v = process.env['VECTOR_ASCII'];
+        const on = v !== undefined ? v !== '0' && v.toLowerCase() !== 'false' : false;
+        return on ? SPINNER_ASCII : SPINNER_BRAILLE;
+    }
+    catch {
+        return SPINNER_BRAILLE;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function version() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const pkg = require('../../package.json');
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agen-vektor",
-  "version": "0.3.32",
+  "version": "0.3.33",
   "description": "VectorHead (agen-vektor) — AI Coding Agent CLI/TUI for Linux & Termux. Multi-provider, tool calling, session, permission system.",
   "type": "commonjs",
   "bin": {