@chispear/vibekit 0.2.0 → 0.4.0

package/README.md

@@ -61,21 +61,25 @@ vibekit status
 | Perintah | Fungsi |
 |---|---|
 | `vibekit init` | Buat `~/.vibekit/config.json` dari template (tidak menimpa yang sudah ada) |
-| `vibekit ask "<pertanyaan>" [--file <path>]... [--dir <path>]...` | Tanya sekali; lampirkan file/folder sebagai konteks terseleksi. Ringkasan hemat token ditulis ke stderr, jawaban bersih di stdout, ditutup baris info model + token terpakai |
-| `vibekit chat` | Percakapan interaktif; riwayat dipangkas otomatis (maks ±4.000 token, giliran tertua dibuang); `/keluar` untuk berhenti |
-| `vibekit do "<tugas>"` | Mode agent: model mengerjakan tugas nyata dengan tool file/perintah di folder saat ini (lihat bagian Mode Agent di bawah) |
+| `vibekit ask "<pertanyaan>" [--file <path>]... [--dir <path>]... [--auto]` | Satu pertanyaan yang boleh berakhir dengan aksi; lampirkan file/folder sebagai konteks terseleksi. Ringkasan hemat token ditulis ke stderr, jawaban bersih di stdout, ditutup baris info model + token terpakai |
+| `vibekit chat [--auto]` | Percakapan interaktif yang juga bisa bertindak di tengah obrolan; riwayat aksi lama dipadatkan jadi ringkasan lalu dipangkas sadar-tool (maks ±4.000 token, hanya pada batas giliran utuh); `/keluar` untuk berhenti, `/auto` untuk menyala-matikan mode auto-allow |
+| `vibekit do "<tugas>"` | Mode agent sekali jalan: model mengerjakan tugas nyata dengan tool file/perintah di folder saat ini (lihat bagian Mode Agent di bawah) |
 | `vibekit status` | Tabel per penyedia: model, status (aktif / cooldown s.d. jam / anggaran tercapai), token terpakai hari ini |
 | `vibekit --help` / `--version` | Bantuan / versi |
 
-## Mode Agent — `vibekit do`
+## Mode Agent — `ask`, `chat`, dan `do`
 
-Selain menjawab pertanyaan, VibeKit bisa **mengerjakan tugas** di folder proyek Anda:
+Selain menjawab pertanyaan, VibeKit bisa **bertindak** di folder proyek Anda. Sejak v0.3.0 kemampuan agent ini menyatu ke semua perintah — pertanyaan biasa dijawab teks seperti biasa, sedangkan permintaan membuat file atau menjalankan perintah dikerjakan lewat tool dengan pagar keamanan yang sama:
+
+- **`vibekit ask`** — satu pertanyaan yang boleh berakhir dengan aksi: `vibekit ask "buatkan file halo.txt berisi sapaan"`.
+- **`vibekit chat`** — ngobrol yang bisa bertindak di tengah percakapan: minta dibuatkan file di giliran mana pun, model memakai tool lalu melanjutkan obrolan dengan riwayat yang utuh (termasuk rangkaian tool-nya).
+- **`vibekit do`** — mode tugas sekali jalan: jejak langkah dicetak, ditutup ringkasan akhir, dan kode keluar mencerminkan berhasil/tidaknya tugas:
 
 ```bash
 vibekit do "buatkan file halo.txt berisi sapaan, lalu tampilkan daftar file di sini"
 ```
 
-Model bekerja langkah demi langkah lewat tool calling (API OpenAI-compatible yang sama, failover router yang sama), sampai ia membalas ringkasan akhir. Ada **5 tool**:
+Model bekerja langkah demi langkah lewat tool calling (API OpenAI-compatible yang sama, failover router yang sama), sampai ia membalas teks akhir. Ada **5 tool**:
 
 | Tool | Fungsi | Konfirmasi? |
 |---|---|---|
@@ -89,7 +93,9 @@ Model bekerja langkah demi langkah lewat tool calling (API OpenAI-compatible yan
 
 - **Hanya folder kerja (cwd).** Semua path di-resolve terhadap folder tempat perintah dijalankan; path yang keluar dari folder itu (mis. `../`) ditolak eksekutor, bahkan bila pengguna menyetujui.
 - **Konfirmasi per aksi.** Setiap aksi yang mengubah file atau menjalankan perintah menampilkan deskripsi aksinya (path + pratinjau konten untuk tulis, potongan teks lama→baru untuk edit, perintah lengkap untuk shell) dan hanya berjalan bila Anda menjawab `y`/`ya` — selain itu dianggap menolak, dan penolakan itu dilaporkan ke model agar ia menyesuaikan rencana.
-- **Batas 12 langkah** per tugas, dan hasil tiap tool dipangkas (±4.000 karakter) sebelum dikirim balik ke model demi hemat token.
+- **Mode auto-allow (opsional, sejak v0.4.0).** Flag `--auto` (alias `--yes`) pada `ask`, `chat`, dan `do` — atau perintah `/auto` di tengah sesi chat — melewati konfirmasi per aksi: semua aksi tulis/perintah langsung dijalankan. Pagar folder kerja TIDAK ikut dilepas (path traversal tetap ditolak), tetapi risikonya nyata: model bisa menulis atau menjalankan sesuatu tanpa sempat Anda periksa. Hanya aktifkan di folder yang aman (folder uji, proyek sekali pakai) dan untuk tugas yang Anda percayai.
+- **Batas 12 langkah** per giliran/tugas, dan hasil tiap tool dipangkas (±4.000 karakter) sebelum dikirim balik ke model demi hemat token.
+- **Riwayat chat yang aman untuk tool.** Pemangkasan riwayat chat hanya terjadi pada batas giliran utuh (satu pesan pengguna + seluruh rangkaian tool-nya), sehingga tidak pernah ada pesan hasil tool yang yatim atau panggilan tool yang kehilangan hasilnya.
 
 ## Cara Failover Bekerja
 
@@ -104,6 +110,7 @@ Model bekerja langkah demi langkah lewat tool calling (API OpenAI-compatible yan
 - **System prompt ringkas** — gaya `poin-penting` memerintahkan model menjawab hanya poin penting tanpa basa-basi; tersedia juga `normal` dan `detail`.
 - **Batas jawaban keras** — `maksTokenJawaban` menjadi `max_tokens` di setiap permintaan.
 - **Konteks terseleksi** — `--file/--dir` melewati file biner & file > 256 KB, memangkas baris komentar penuh dan baris kosong berlebih, dan membatasi total konteks (±16.000 token) dengan memotong berkas terbesar. Selisih token mentah vs terseleksi selalu ditampilkan.
+- **Kompaksi riwayat aksi (chat)** — rangkaian tool giliran-giliran lama dipadatkan menjadi ringkasan satu baris (`[Aksi selesai: tulis_file index.html — OK]`) sebelum giliran baru dimulai, jadi isi file yang pernah ditulis/dibaca model tidak dikirim ulang ke API di setiap giliran. Giliran terakhir tidak pernah disentuh kompaksi, sehingga `thought_signature` Gemini tetap utuh selama dibutuhkan.
 - **Anggaran & pencatatan** — pemakaian per penyedia per hari terlihat di `vibekit status`, sehingga boros selalu kelihatan.
 
 ## Pengembangan
@@ -118,7 +125,7 @@ Keputusan repo: `dist/` masuk `.gitignore` dan dibangun saat publish (`prepublis
 
 ## Status Nama di npm
 
-Package ini terbit di npm sebagai **`@chispear/vibekit`** (v0.1.0, 25 Oktober 2026; v0.2.0 menambahkan mode agent `vibekit do`) karena nama tak-scoped `vibekit` sudah dipakai proyek lain. Nama perintah CLI tetap `vibekit`.
+Package ini terbit di npm sebagai **`@chispear/vibekit`** (v0.1.0, 25 Oktober 2026; v0.2.0 menambahkan mode agent `vibekit do`; v0.3.0 menggabungkan kemampuan agent itu ke `ask` dan `chat`) karena nama tak-scoped `vibekit` sudah dipakai proyek lain. Nama perintah CLI tetap `vibekit`.
 
 ## Lisensi
 

package/dist/agent.js

@@ -2,6 +2,7 @@ import { exec } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { tanyaRouter } from "./router.js";
+import { hitungToken } from "./token.js";
 /** Hasil tool dipangkas sampai ±karakter ini sebelum dikirim balik ke model (hemat token). */
 const BATAS_HASIL_TOOL = 4000;
 /** Batas waktu jalankan_perintah. */
@@ -99,6 +100,20 @@ const SYSTEM_PROMPT_AGENT = [
     "Jangan mengarang isi file: gunakan daftar_file/baca_file dulu bila perlu mengetahui isi folder/file.",
     "Bila tugas selesai (atau tidak bisa dilanjutkan), balas TANPA memanggil tool, berisi ringkasan akhir yang singkat dalam poin-poin penting: apa yang dilakukan dan hasilnya.",
 ].join(" ");
+/**
+ * System prompt gabungan untuk `ask` dan `chat` (sejak v0.3.0): model adalah
+ * lawan bicara yang menjawab pertanyaan biasa langsung sebagai teks, tetapi
+ * juga bisa bertindak memakai tool yang sama seperti mode agent bila diminta.
+ */
+export const SYSTEM_PROMPT_GABUNGAN = [
+    "Kamu adalah lawan bicara VibeKit yang bekerja di dalam SATU folder kerja pengguna.",
+    "Jawab pertanyaan biasa langsung sebagai teks, singkat dan hanya poin-poin penting.",
+    "Bila pengguna meminta dibuatkan/diubah file atau menjalankan perintah, gunakan tool yang tersedia: daftar_file, baca_file, tulis_file, edit_file, jalankan_perintah.",
+    "Semua path bersifat relatif terhadap folder kerja; jangan pernah mencoba mengakses apa pun di luar folder itu.",
+    "Aksi tulis_file, edit_file, dan jalankan_perintah selalu meminta persetujuan pengguna dulu; bila pengguna menolak, jangan memaksa dan jangan mengulang aksi yang sama.",
+    "Jangan mengarang isi file: gunakan daftar_file/baca_file dulu bila perlu mengetahui isi folder/file.",
+    "Setelah bertindak, tutup giliran dengan balasan teks (tanpa tool) berisi ringkasan singkat: apa yang dilakukan dan hasilnya. Ringkasan itu TIDAK BOLEH mengulang isi file yang ditulis atau dibaca — cukup sebutkan nama file dan hasilnya.",
+].join(" ");
 /**
  * Resolve path masukan terhadap cwd. Mengembalikan null bila hasil resolve
  * keluar dari cwd (path traversal) — kunci keamanan mode agent.
@@ -137,6 +152,8 @@ function argumenRingkas(nama, arg) {
             return potong(JSON.stringify(arg), 80);
     }
 }
+/** Nama tool yang mengubah sesuatu — wajib konfirmasi kecuali mode auto-allow. */
+const TOOL_MUTASI = new Set(["tulis_file", "edit_file", "jalankan_perintah"]);
 /**
  * Jalankan satu panggilan tool. Selalu mengembalikan teks hasil untuk model
  * (tidak pernah throw): keberhasilan diawali "OK:", kegagalan "ERROR:",
@@ -152,6 +169,10 @@ export async function eksekusiTool(panggilan, konteks) {
         return `ERROR: argumen untuk tool ${nama} bukan JSON yang valid.`;
     }
     const { cwd, konfirmasi } = konteks;
+    // Mode auto-allow: callback konfirmasi pengguna tidak dipanggil sama sekali —
+    // aksi mutasi langsung disetujui. Pagar cwd (resolusiAman) TIDAK berubah dan
+    // tetap menolak path traversal walau auto-allow aktif.
+    const konfirmasiEfektif = konteks.autoAllow ? async () => true : konfirmasi;
     const ambilPath = (mentah) => {
         const masukan = typeof mentah === "string" && mentah.trim() !== "" ? mentah : ".";
         const tujuan = resolusiAman(cwd, masukan);
@@ -188,7 +209,7 @@ export async function eksekusiTool(panggilan, konteks) {
                 const konten = typeof arg.konten === "string" ? arg.konten : "";
                 const deskripsi = `tulis_file → ${p.rel} (${konten.length} karakter)\n` +
                     `Pratinjau konten:\n${potong(konten, 300)}`;
-                if (!(await konfirmasi(deskripsi))) {
+                if (!(await konfirmasiEfektif(deskripsi))) {
                     return `DITOLAK: pengguna menolak aksi tulis_file ke ${p.rel}. File tidak ditulis. Jangan mengulang aksi yang sama; sesuaikan rencana atau akhiri dengan ringkasan.`;
                 }
                 await fs.mkdir(path.dirname(p.tujuan), { recursive: true });
@@ -209,7 +230,7 @@ export async function eksekusiTool(panggilan, konteks) {
                 const deskripsi = `edit_file → ${p.rel}\n` +
                     `Teks lama: ${potong(teksLama, 150)}\n` +
                     `Teks baru: ${potong(teksBaru, 150)}`;
-                if (!(await konfirmasi(deskripsi))) {
+                if (!(await konfirmasiEfektif(deskripsi))) {
                     return `DITOLAK: pengguna menolak aksi edit_file di ${p.rel}. File tidak diubah. Jangan mengulang aksi yang sama; sesuaikan rencana atau akhiri dengan ringkasan.`;
                 }
                 const baru = isi.slice(0, idx) + teksBaru + isi.slice(idx + teksLama.length);
@@ -221,7 +242,7 @@ export async function eksekusiTool(panggilan, konteks) {
                 if (!perintah)
                     return "ERROR: argumen perintah kosong.";
                 const deskripsi = `jalankan_perintah → ${perintah}`;
-                if (!(await konfirmasi(deskripsi))) {
+                if (!(await konfirmasiEfektif(deskripsi))) {
                     return `DITOLAK: pengguna menolak menjalankan perintah "${perintah}". Perintah tidak dijalankan. Jangan mengulang aksi yang sama; sesuaikan rencana atau akhiri dengan ringkasan.`;
                 }
                 const hasil = await new Promise((resolve) => {
@@ -256,17 +277,24 @@ export async function eksekusiTool(panggilan, konteks) {
     }
 }
 /**
- * Loop mode agent: panggil router (dengan tools) → jalankan tool_calls yang
- * diminta model lewat eksekutor aman → kirim hasil tool balik → ulangi sampai
- * model membalas teks tanpa tool_calls (ringkasan akhir) atau langkah habis.
+ * Inti loop agent untuk SATU giliran: panggil router (dengan tools) → jalankan
+ * tool_calls yang diminta model lewat eksekutor aman → kirim hasil tool balik
+ * → ulangi sampai model membalas teks tanpa tool_calls atau langkah habis.
+ * Dipakai bersama oleh `do` (lewat jalankanAgent), `ask`, dan `chat`.
+ *
+ * Catatan kegagalan: bila router gagal di tengah giliran, `messages` mungkin
+ * sudah memuat rangkaian parsial (assistant tool_calls + hasil tool tanpa teks
+ * akhir). Pemanggil yang menyimpan riwayat (chat) sebaiknya menggulung balik
+ * giliran itu; pemanggil sekali jalan (ask/do) bisa mengabaikannya.
  */
-export async function jalankanAgent(opsi) {
+export async function jalankanGiliran(opsi) {
     const maksLangkah = opsi.maksLangkah ?? MAKS_LANGKAH_BAWAAN;
+    const messages = opsi.messages;
     const catatan = [];
-    const messages = [
-        { role: "system", content: SYSTEM_PROMPT_AGENT },
-        { role: "user", content: opsi.tugas },
-    ];
+    let totalToken = 0;
+    let semuaUsage = true;
+    let providerTerakhir = null;
+    const sumber = () => (semuaUsage ? "usage" : "estimasi");
     let langkah = 0;
     while (langkah < maksLangkah) {
         langkah++;
@@ -279,18 +307,49 @@ export async function jalankanAgent(opsi) {
         });
         catatan.push(...hasil.catatan);
         if (!hasil.ok) {
-            return { ok: false, ringkasan: hasil.pesan, jumlahLangkah: langkah, catatan };
+            return {
+                ok: false,
+                jawabanAkhir: "",
+                providerTerakhir,
+                totalToken,
+                tokenSumber: sumber(),
+                jumlahLangkah: langkah,
+                catatan,
+                pesanGagal: hasil.pesan,
+            };
         }
+        totalToken += hasil.tokenTerpakai;
+        if (hasil.tokenSumber !== "usage")
+            semuaUsage = false;
+        providerTerakhir = hasil.provider;
         const panggilan = hasil.toolCalls ?? [];
         if (panggilan.length === 0) {
-            // Balasan teks murni = ringkasan akhir dari model.
-            return { ok: true, ringkasan: hasil.jawaban, jumlahLangkah: langkah, catatan };
+            // Balasan teks murni = jawaban akhir giliran; simpan ke riwayat agar utuh.
+            messages.push({ role: "assistant", content: hasil.jawaban });
+            return {
+                ok: true,
+                jawabanAkhir: hasil.jawaban,
+                providerTerakhir,
+                totalToken,
+                tokenSumber: sumber(),
+                jumlahLangkah: langkah,
+                catatan,
+            };
+        }
+        if (hasil.pesanMentah && typeof hasil.pesanMentah === "object") {
+            // Teruskan pesan assistant persis seperti yang dikirim penyedia. Gemini 3
+            // menyisipkan thought_signature di dalam tool_calls (extra_content) dan
+            // menolak permintaan berikutnya dengan HTTP 400 bila tanda tangan itu
+            // hilang dari riwayat — jadi pesan mentah tidak boleh dibangun ulang.
+            messages.push(hasil.pesanMentah);
+        }
+        else {
+            messages.push({
+                role: "assistant",
+                content: hasil.jawaban ? hasil.jawaban : null,
+                tool_calls: panggilan,
+            });
         }
-        messages.push({
-            role: "assistant",
-            content: hasil.jawaban ? hasil.jawaban : null,
-            tool_calls: panggilan,
-        });
         for (const p of panggilan) {
             let argRingkas = "";
             try {
@@ -299,8 +358,13 @@ export async function jalankanAgent(opsi) {
             catch {
                 argRingkas = "";
             }
-            opsi.jejak?.(`langkah ${langkah}: ${p.function.name}${argRingkas ? ` (${argRingkas})` : ""}`);
-            const hasilTool = await eksekusiTool(p, { cwd: opsi.cwd, konfirmasi: opsi.konfirmasi });
+            const penandaAuto = opsi.autoAllow && TOOL_MUTASI.has(p.function.name) ? " (auto)" : "";
+            opsi.jejak?.(`langkah ${langkah}: ${p.function.name}${argRingkas ? ` (${argRingkas})` : ""}${penandaAuto}`);
+            const hasilTool = await eksekusiTool(p, {
+                cwd: opsi.cwd,
+                konfirmasi: opsi.konfirmasi,
+                autoAllow: opsi.autoAllow,
+            });
             opsi.jejak?.(`  → ${potong(hasilTool.split("\n")[0], 120)}`);
             messages.push({
                 role: "tool",
@@ -312,9 +376,195 @@ export async function jalankanAgent(opsi) {
     }
     return {
         ok: false,
-        ringkasan: `Batas langkah tercapai (${maksLangkah} langkah) sebelum tugas selesai. ` +
-            "Jalankan lagi perintah yang sama untuk melanjutkan, atau persempit tugasnya.",
+        jawabanAkhir: "",
+        providerTerakhir,
+        totalToken,
+        tokenSumber: sumber(),
         jumlahLangkah: langkah,
         catatan,
+        batasTercapai: true,
     };
 }
+/** Perkiraan token satu pesan: konten teks ditambah argumen tool_calls (bila ada). */
+function tokenPesan(m) {
+    let teks = m.content ?? "";
+    if (m.tool_calls && m.tool_calls.length > 0)
+        teks += "\n" + JSON.stringify(m.tool_calls);
+    return hitungToken(teks);
+}
+/**
+ * Pangkas riwayat percakapan secara SADAR-TOOL: pemotongan hanya terjadi pada
+ * batas giliran utuh. Satu giliran = satu pesan "user" beserta seluruh
+ * rangkaian sesudahnya sampai sebelum "user" berikutnya (assistant tool_calls,
+ * hasil-hasil tool, assistant teks akhir). Fungsi ini TIDAK PERNAH menyisakan
+ * pesan "tool" yatim atau assistant tool_calls tanpa hasil tool-nya.
+ *
+ * Awalan pesan "system" (bila ada) selalu dipertahankan karena bukan bagian
+ * giliran mana pun. Giliran terakhir selalu dipertahankan utuh, jadi hasil
+ * boleh tetap melebihi maksToken bila satu giliran terakhir saja sudah
+ * sebesar itu. Tidak mengubah array masukan; mengembalikan array baru.
+ */
+export function pangkasRiwayatAman(messages, maksToken) {
+    let awal = 0;
+    while (awal < messages.length && messages[awal].role === "system")
+        awal++;
+    const awalan = messages.slice(0, awal);
+    const sisa = messages.slice(awal);
+    // Kelompokkan sisa menjadi giliran-giliran: grup baru dimulai di setiap
+    // pesan "user"; pesan sebelum "user" pertama membentuk grupnya sendiri.
+    const grup = [];
+    for (const m of sisa) {
+        if (m.role === "user" || grup.length === 0)
+            grup.push([m]);
+        else
+            grup[grup.length - 1].push(m);
+    }
+    const tokenGrup = (g) => g.reduce((s, m) => s + tokenPesan(m), 0);
+    let total = awalan.reduce((s, m) => s + tokenPesan(m), 0) + grup.reduce((s, g) => s + tokenGrup(g), 0);
+    // Buang giliran tertua secara utuh sampai muat; giliran terakhir tak dibuang.
+    while (total > maksToken && grup.length > 1) {
+        total -= tokenGrup(grup.shift());
+    }
+    return [...awalan, ...grup.flat()];
+}
+/** Target ringkas satu panggilan tool untuk pesan ringkasan kompaksi. */
+function targetRingkasTool(panggilan) {
+    let arg = {};
+    try {
+        arg = JSON.parse(panggilan.function.arguments || "{}");
+    }
+    catch {
+        // Argumen rusak: target dikosongkan, ringkasan tetap dibuat dari nama tool.
+    }
+    if (panggilan.function.name === "jalankan_perintah") {
+        return potong(String(arg.perintah ?? ""), 40);
+    }
+    return String(arg.path ?? ".");
+}
+/** Status satu hasil tool dari awalannya: "OK" | "ERROR" | "DITOLAK" | kata pertama. */
+function statusHasilTool(konten) {
+    const t = (konten ?? "").trimStart();
+    if (t.startsWith("OK"))
+        return "OK";
+    if (t.startsWith("ERROR"))
+        return "ERROR";
+    if (t.startsWith("DITOLAK"))
+        return "DITOLAK";
+    return t.split(/[:\s]/)[0] || "?";
+}
+/** Padatkan satu giliran LAMA (bukan giliran terakhir) — lihat kompaksiRiwayatAksi. */
+function kompaksiSatuGiliran(giliran) {
+    const keluar = [];
+    let i = 0;
+    while (i < giliran.length) {
+        const m = giliran[i];
+        if (m.role === "assistant" && m.tool_calls && m.tool_calls.length > 0) {
+            // Kumpulkan pesan-pesan tool milik rangkaian ini.
+            const hasilTool = [];
+            let j = i + 1;
+            while (j < giliran.length && giliran[j].role === "tool") {
+                hasilTool.push(giliran[j]);
+                j++;
+            }
+            // Teks pendamping pada pesan assistant (jarang ada) dipertahankan.
+            if (typeof m.content === "string" && m.content.trim() !== "") {
+                keluar.push({ role: "assistant", content: m.content });
+            }
+            // Satu pesan ringkasan per panggilan tool, menggantikan seluruh
+            // rangkaian — argumen lengkap (termasuk isi file) dan thought_signature
+            // ikut terbuang di sini, memang itu tujuannya (hemat token).
+            for (const p of m.tool_calls) {
+                const pasangan = hasilTool.find((t) => t.tool_call_id === p.id) ?? hasilTool[0];
+                const status = statusHasilTool(pasangan?.content ?? null);
+                const target = targetRingkasTool(p);
+                keluar.push({
+                    role: "assistant",
+                    content: `[Aksi selesai: ${p.function.name}${target ? ` ${target}` : ""} — ${status}]`,
+                });
+            }
+            i = j;
+        }
+        else if (m.role === "tool") {
+            // Pesan tool yatim tanpa rangkaian assistant pendahulu dalam giliran
+            // yang sama: buang (tidak sah dikirim ke API tanpa pendahulunya).
+            i++;
+        }
+        else {
+            keluar.push(m);
+            i++;
+        }
+    }
+    return keluar;
+}
+/**
+ * Kompaksi riwayat aksi untuk chat: ganti rangkaian tool pada giliran-giliran
+ * LAMA menjadi ringkasan teks satu baris, agar isi file yang ditulis model
+ * (argumen tool_calls) tidak ikut dikirim ulang ke API pada setiap giliran
+ * berikutnya. Bentuk ringkasan: `[Aksi selesai: <tool> <target> — <status>]`.
+ *
+ * Aturan keras:
+ * - Giliran TERAKHIR tidak disentuh sama sekali — pesan assistant mentahnya
+ *   (termasuk thought_signature Gemini di dalam tool_calls) wajib utuh
+ *   selama giliran itu masih aktif/baru selesai.
+ * - Pesan sebelum "user" pertama (mis. system) dipertahankan apa adanya.
+ * - Pesan user dan assistant teks biasa dipertahankan apa adanya.
+ * - Mengembalikan array BARU; array masukan tidak diubah.
+ */
+export function kompaksiRiwayatAksi(messages) {
+    let awal = 0;
+    while (awal < messages.length && messages[awal].role !== "user")
+        awal++;
+    const awalan = messages.slice(0, awal);
+    const sisa = messages.slice(awal);
+    const grup = [];
+    for (const m of sisa) {
+        if (m.role === "user" || grup.length === 0)
+            grup.push([m]);
+        else
+            grup[grup.length - 1].push(m);
+    }
+    const hasil = [...awalan];
+    grup.forEach((giliran, gi) => {
+        if (gi === grup.length - 1)
+            hasil.push(...giliran);
+        else
+            hasil.push(...kompaksiSatuGiliran(giliran));
+    });
+    return hasil;
+}
+/**
+ * Mode tugas sekali jalan (`vibekit do`): satu giliran agent dengan system
+ * prompt pelaksana tugas, dibangun di atas jalankanGiliran. Perilaku dan
+ * bentuk HasilAgent sama seperti sebelum refaktor v0.3.0.
+ */
+export async function jalankanAgent(opsi) {
+    const maksLangkah = opsi.maksLangkah ?? MAKS_LANGKAH_BAWAAN;
+    const messages = [
+        { role: "system", content: SYSTEM_PROMPT_AGENT },
+        { role: "user", content: opsi.tugas },
+    ];
+    const hasil = await jalankanGiliran({
+        config: opsi.config,
+        messages,
+        lokasiState: opsi.lokasiState,
+        cwd: opsi.cwd,
+        konfirmasi: opsi.konfirmasi,
+        autoAllow: opsi.autoAllow,
+        fetchImpl: opsi.fetchImpl,
+        maksLangkah: opsi.maksLangkah,
+        jejak: opsi.jejak,
+    });
+    if (hasil.pesanGagal !== undefined) {
+        return { ok: false, ringkasan: hasil.pesanGagal, jumlahLangkah: hasil.jumlahLangkah, catatan: hasil.catatan };
+    }
+    if (hasil.batasTercapai) {
+        return {
+            ok: false,
+            ringkasan: `Batas langkah tercapai (${maksLangkah} langkah) sebelum tugas selesai. ` +
+                "Jalankan lagi perintah yang sama untuk melanjutkan, atau persempit tugasnya.",
+            jumlahLangkah: hasil.jumlahLangkah,
+            catatan: hasil.catatan,
+        };
+    }
+    return { ok: true, ringkasan: hasil.jawabanAkhir, jumlahLangkah: hasil.jumlahLangkah, catatan: hasil.catatan };
+}

package/dist/banner.js

@@ -0,0 +1,36 @@
+// Banner CHISPEAR hijau besar — ditampilkan saat `vibekit init` pertama kali
+// (momen "berhasil terpasang & diatur" yang pasti terlihat pengguna, karena
+// keluaran skrip postinstall npm tidak selalu ditampilkan npm).
+// CATATAN: scripts/banner.js adalah salinan mandiri dari seni ini untuk
+// postinstall — jaga keduanya tetap sinkron.
+const GLIF = {
+    C: [" █████ ", "██   ██", "██     ", "██     ", "██   ██", " █████ "],
+    H: ["██   ██", "██   ██", "███████", "██   ██", "██   ██", "██   ██"],
+    I: ["███", " █ ", " █ ", " █ ", " █ ", "███"],
+    S: ["███████", "██     ", "██████ ", "     ██", "     ██", "██████ "],
+    P: ["██████ ", "██   ██", "██████ ", "██     ", "██     ", "██     "],
+    E: ["███████", "██     ", "█████  ", "█████  ", "██     ", "███████"],
+    A: [" █████ ", "██   ██", "███████", "██   ██", "██   ██", "██   ██"],
+    R: ["██████ ", "██   ██", "██████ ", "██  ██ ", "██   ██", "██   ██"],
+};
+/** Teks banner CHISPEAR (hijau terang bila NO_COLOR tidak diset). */
+export function teksBanner() {
+    const baris = ["", "", "", "", "", ""];
+    for (const huruf of "CHISPEAR") {
+        const g = GLIF[huruf];
+        if (!g)
+            continue;
+        for (let i = 0; i < 6; i++)
+            baris[i] += (baris[i] ? "  " : "") + g[i];
+    }
+    const pakaiWarna = !process.env.NO_COLOR;
+    const HIJAU = pakaiWarna ? "\x1b[1;92m" : "";
+    const RESET = pakaiWarna ? "\x1b[0m" : "";
+    return [
+        "",
+        ...baris.map((b) => HIJAU + b + RESET),
+        "",
+        HIJAU + "  VibeKit CLI terpasang — router AI hemat tokenmu siap dipakai." + RESET,
+        "",
+    ].join("\n");
+}

package/dist/cli.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import readline from "node:readline";
 import { buatConfigGlobal, globalConfigPath, muatConfig, statePath, } from "./config.js";
-import { jalankanAgent } from "./agent.js";
+import { jalankanAgent, jalankanGiliran, kompaksiRiwayatAksi, pangkasRiwayatAman, SYSTEM_PROMPT_GABUNGAN, } from "./agent.js";
+import { teksBanner } from "./banner.js";
 import { bangunKonteks } from "./context.js";
-import { tanyaRouter } from "./router.js";
 import { formatJam, muatState, sedangCooldown, statePenyedia, } from "./state.js";
-import { formatAngka, hitungToken } from "./token.js";
-const VERSI = "0.2.0";
+import { formatAngka } from "./token.js";
+const VERSI = "0.4.0";
 const BATAS_TOKEN_RIWAYAT = 4000;
 function bantuan() {
     console.log(`VibeKit CLI v${VERSI} — router AI hemat token dengan failover otomatis
 
 Penggunaan:
   vibekit init                          Buat ~/.vibekit/config.json dari template
-  vibekit ask "<pertanyaan>" [opsi]     Tanya sekali lewat router
-  vibekit chat                          Percakapan interaktif (perintah /keluar untuk berhenti)
-  vibekit do "<tugas>"                  Mode agent: kerjakan tugas dengan tool file/perintah di folder ini
+  vibekit ask "<pertanyaan>" [opsi]     Tanya sekali (bisa bertindak: membuat file & menjalankan perintah dengan persetujuanmu)
+  vibekit chat                          Percakapan interaktif yang juga bisa bertindak (perintah /keluar untuk berhenti)
+  vibekit do "<tugas>"                  Mode agent sekali jalan: kerjakan tugas dengan tool file/perintah di folder ini
   vibekit status                        Status & pemakaian token tiap penyedia hari ini
   vibekit --help                        Tampilkan bantuan ini
   vibekit --version                     Tampilkan versi
@@ -23,12 +23,26 @@ Penggunaan:
 Opsi ask:
   --file <path>    Lampirkan file sebagai konteks (boleh diulang)
   --dir <path>     Lampirkan isi folder sebagai konteks (boleh diulang)
+  --auto, --yes    Mode auto-allow: aksi tulis/perintah langsung dijalankan
+                   tanpa persetujuan (tetap terkunci di folder kerja)
 
-Mode agent (do):
-  Agent bekerja HANYA di folder tempat perintah dijalankan. Tool baca
-  (daftar_file, baca_file) berjalan langsung; tool yang mengubah sesuatu
-  (tulis_file, edit_file, jalankan_perintah) selalu meminta persetujuanmu
-  satu per satu — jawaban selain y/ya berarti ditolak. Batas 12 langkah.
+Opsi chat & do:
+  --auto, --yes    Mode auto-allow seperti di atas. Di tengah sesi chat,
+                   perintah /auto menyalakan/mematikan mode ini kapan saja.
+
+Kemampuan agent (ask, chat, do):
+  Sejak v0.3.0 ketiga perintah itu bisa bertindak, bukan hanya menjawab:
+  bila kamu meminta dibuatkan/diubah file atau menjalankan perintah, model
+  memakai tool di folder tempat perintah dijalankan. Tool baca (daftar_file,
+  baca_file) berjalan langsung; tool yang mengubah sesuatu (tulis_file,
+  edit_file, jalankan_perintah) selalu meminta persetujuanmu satu per satu
+  — jawaban selain y/ya berarti ditolak. Batas 12 langkah per giliran.
+  Mode auto-allow (--auto/--yes, atau /auto di chat) melewati persetujuan
+  itu: semua aksi langsung dijalankan, pagar folder kerja tetap berlaku.
+  Hanya aktifkan di folder yang aman dan untuk tugas yang kamu percayai.
+  Perbedaannya: ask = satu pertanyaan yang boleh berakhir dengan aksi,
+  chat = percakapan yang bisa bertindak di tengah obrolan,
+  do = mode tugas sekali jalan dengan jejak langkah & ringkasan akhir.
   Contoh: vibekit do "buatkan file halo.txt berisi sapaan, lalu tampilkan daftar file di sini"
 
 Cara kerja singkat:
@@ -41,6 +55,7 @@ Cara kerja singkat:
 function perintahInit() {
     const dibuat = buatConfigGlobal();
     if (dibuat) {
+        console.log(teksBanner());
         console.log(`Konfigurasi dibuat: ${globalConfigPath()}`);
         console.log("Isi kolom \"apiKey\" untuk tiap penyedia yang ingin dipakai (atau pakai sintaks \"env:NAMA_VAR\").");
         console.log("Urutan penyedia = prioritas: yang pertama adalah bawaan, berikutnya cadangan failover.");
@@ -51,10 +66,15 @@ function perintahInit() {
     }
     return 0;
 }
+/** Satu baris peringatan yang dicetak di awal perintah saat mode auto-allow aktif. */
+function cetakPeringatanAuto() {
+    console.error("[vibekit] Mode auto-allow AKTIF: aksi tulis file & menjalankan perintah akan dijalankan TANPA persetujuanmu. Agent tetap terkunci di folder kerja ini.");
+}
 function uraiArgAsk(args) {
     const files = [];
     const dirs = [];
     const sisa = [];
+    let auto = false;
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
         if (a === "--file") {
@@ -75,6 +95,9 @@ function uraiArgAsk(args) {
         else if (a.startsWith("--dir=")) {
             dirs.push(a.slice("--dir=".length));
         }
+        else if (a === "--auto" || a === "--yes") {
+            auto = true;
+        }
         else {
             sisa.push(a);
         }
@@ -82,20 +105,48 @@ function uraiArgAsk(args) {
     const pertanyaan = sisa.join(" ").trim();
     if (!pertanyaan)
         return { error: "Pertanyaan kosong. Contoh: vibekit ask \"apa itu API?\"" };
-    return { pertanyaan, files, dirs };
+    return { pertanyaan, files, dirs, auto };
 }
-function tampilkanHasil(hasil) {
-    if (hasil.ok) {
-        console.log(hasil.jawaban);
-        const sumber = hasil.tokenSumber === "usage" ? "dari usage API" : "estimasi";
-        console.log(`\n— dijawab oleh ${hasil.provider.nama} (${hasil.provider.model}) • ${formatAngka(hasil.tokenTerpakai)} token (${sumber})`);
-        for (const c of hasil.catatan) {
-            console.error(`[vibekit] dilewati ${c.nama}: ${c.alasan}`);
-        }
-        return 0;
-    }
-    console.error(hasil.pesan);
-    return 1;
+function buatPembacaBaris() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const antrian = [];
+    const penunggu = [];
+    let berakhir = false;
+    rl.on("line", (baris) => {
+        const p = penunggu.shift();
+        if (p)
+            p(baris);
+        else
+            antrian.push(baris);
+    });
+    rl.on("close", () => {
+        berakhir = true;
+        while (penunggu.length > 0)
+            penunggu.shift()(null);
+    });
+    return {
+        tanya: (prompt) => {
+            process.stdout.write(prompt);
+            const siap = antrian.shift();
+            if (siap !== undefined)
+                return Promise.resolve(siap);
+            if (berakhir)
+                return Promise.resolve(null);
+            return new Promise((resolve) => penunggu.push(resolve));
+        },
+        tutup: () => rl.close(),
+    };
+}
+/** Pembuat callback konfirmasi bersama untuk do/ask/chat di atas satu PembacaBaris. */
+function buatKonfirmasi(pembaca) {
+    return async (deskripsi) => {
+        console.log(`\n[vibekit] Usulan aksi:\n${deskripsi}`);
+        const jawaban = await pembaca.tanya("Jalankan? (y/N) ");
+        if (jawaban === null)
+            return false; // EOF: tolak demi keamanan
+        const j = jawaban.trim().toLowerCase();
+        return j === "y" || j === "ya";
+    };
 }
 async function perintahAsk(args) {
     const urai = uraiArgAsk(args);
@@ -125,14 +176,50 @@ async function perintahAsk(args) {
         for (const d of konteks.dilewati)
             console.error(`[vibekit] konteks dilewati: ${d}`);
     }
-    const hasil = await tanyaRouter({
-        config,
-        messages: [{ role: "user", content: isiUser }],
-        lokasiState: statePath(),
-    });
-    return tampilkanHasil(hasil);
+    // Sejak v0.3.0 ask menjalankan SATU giliran agent: pertanyaan biasa dijawab
+    // teks langsung, permintaan membuat file/perintah dijalankan lewat tool
+    // dengan konfirmasi — pagar keamanan yang sama seperti `do`.
+    const messages = [
+        { role: "system", content: SYSTEM_PROMPT_GABUNGAN },
+        { role: "user", content: isiUser },
+    ];
+    if (urai.auto)
+        cetakPeringatanAuto();
+    const pembaca = buatPembacaBaris();
+    try {
+        const hasil = await jalankanGiliran({
+            config,
+            messages,
+            lokasiState: statePath(),
+            cwd: process.cwd(),
+            konfirmasi: buatKonfirmasi(pembaca),
+            autoAllow: urai.auto,
+            jejak: (pesan) => console.error(`[vibekit] ${pesan}`),
+        });
+        if (!hasil.ok) {
+            if (hasil.batasTercapai) {
+                console.error(`[vibekit] Batas langkah tercapai (${hasil.jumlahLangkah} langkah) sebelum pertanyaan ini selesai dikerjakan. Persempit permintaanmu, atau gunakan vibekit do untuk mode tugas.`);
+            }
+            else {
+                console.error(hasil.pesanGagal ?? "[vibekit] Semua penyedia gagal atau sedang tidak tersedia.");
+            }
+            return 1;
+        }
+        console.log(hasil.jawabanAkhir);
+        if (hasil.providerTerakhir) {
+            const sumber = hasil.tokenSumber === "usage" ? "dari usage API" : "estimasi";
+            console.log(`\n— dijawab oleh ${hasil.providerTerakhir.nama} (${hasil.providerTerakhir.model}) • ${formatAngka(hasil.totalToken)} token (${sumber})`);
+        }
+        for (const c of hasil.catatan) {
+            console.error(`[vibekit] dilewati ${c.nama}: ${c.alasan}`);
+        }
+        return 0;
+    }
+    finally {
+        pembaca.tutup();
+    }
 }
-async function perintahChat() {
+async function perintahChat(args) {
     let config;
     try {
         config = muatConfig().config;
@@ -141,58 +228,87 @@ async function perintahChat() {
         console.error(`[vibekit] ${e.message}`);
         return 2;
     }
+    // Mode auto-allow bisa dinyalakan dari flag --auto/--yes, lalu diubah
+    // kapan saja di tengah sesi dengan perintah /auto.
+    let autoAktif = args.includes("--auto") || args.includes("--yes");
     console.log("VibeKit chat — ketik pertanyaan, /keluar untuk berhenti.");
-    const riwayat = [];
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: "kamu> " });
-    let rlDitutup = false;
-    rl.on("close", () => {
-        rlDitutup = true;
-    });
-    const promptAman = () => {
-        if (!rlDitutup) {
-            try {
-                rl.prompt();
+    console.log("Chat ini juga bisa bertindak: minta saja dibuatkan file atau menjalankan perintah — setiap aksi meminta persetujuanmu dulu.");
+    console.log("Perintah /auto menyalakan/mematikan mode auto-allow (aksi tanpa persetujuan) di tengah sesi.");
+    if (autoAktif)
+        cetakPeringatanAuto();
+    const riwayat = [{ role: "system", content: SYSTEM_PROMPT_GABUNGAN }];
+    const pembaca = buatPembacaBaris();
+    const konfirmasi = buatKonfirmasi(pembaca);
+    try {
+        for (;;) {
+            const barisMentah = await pembaca.tanya("kamu> ");
+            if (barisMentah === null)
+                break; // stdin berakhir (EOF)
+            const baris = barisMentah.trim();
+            if (baris === "/keluar" || baris === "/exit")
+                break;
+            if (!baris)
+                continue;
+            if (baris === "/auto") {
+                autoAktif = !autoAktif;
+                console.log(autoAktif
+                    ? "[vibekit] Mode auto-allow: AKTIF — aksi tulis file & menjalankan perintah berikutnya dijalankan TANPA persetujuan. Agent tetap terkunci di folder kerja ini."
+                    : "[vibekit] Mode auto-allow: NONAKTIF — aksi tulis file & menjalankan perintah kembali meminta persetujuanmu satu per satu.");
+                continue;
             }
-            catch {
-                /* readline sudah tertutup (EOF) — abaikan */
+            riwayat.push({ role: "user", content: baris });
+            // Kompaksi riwayat aksi DULU: rangkaian tool giliran-giliran lama
+            // diganti ringkasan satu baris agar isi file tidak terkirim ulang.
+            // Giliran terakhir (yang baru saja ditambahkan pesan user-nya ini
+            // menjadi giliran terakhir) tidak disentuh kompaksi.
+            const terkompaksi = kompaksiRiwayatAksi(riwayat);
+            riwayat.splice(0, riwayat.length, ...terkompaksi);
+            // Lalu Pangkas SADAR-TOOL: hanya pada batas giliran utuh, tidak pernah
+            // menyisakan pesan tool yatim atau tool_calls tanpa hasilnya.
+            const terpotong = pangkasRiwayatAman(riwayat, BATAS_TOKEN_RIWAYAT);
+            riwayat.splice(0, riwayat.length, ...terpotong);
+            const hasil = await jalankanGiliran({
+                config,
+                messages: riwayat,
+                lokasiState: statePath(),
+                cwd: process.cwd(),
+                konfirmasi,
+                autoAllow: autoAktif,
+                jejak: (pesan) => console.error(`[vibekit] ${pesan}`),
+            });
+            if (hasil.ok) {
+                console.log(`\nvibekit (${hasil.providerTerakhir?.nama ?? "?"})> ${hasil.jawabanAkhir}\n`);
+            }
+            else {
+                // Giliran gagal/batas tercapai: gulung balik SELURUH giliran ini
+                // (pesan user + rangkaian parsialnya) agar riwayat tetap bersih.
+                let idxUser = -1;
+                for (let i = riwayat.length - 1; i >= 0; i--) {
+                    if (riwayat[i].role === "user") {
+                        idxUser = i;
+                        break;
+                    }
+                }
+                if (idxUser >= 0)
+                    riwayat.length = idxUser;
+                const pesan = hasil.batasTercapai
+                    ? `Batas langkah tercapai (${hasil.jumlahLangkah} langkah) pada giliran ini; giliran dibatalkan. Persempit permintaanmu.`
+                    : (hasil.pesanGagal ?? "Semua penyedia gagal atau sedang tidak tersedia.");
+                console.error(`\n${pesan}\n`);
             }
         }
-    };
-    promptAman();
-    for await (const barisMentah of rl) {
-        const baris = barisMentah.trim();
-        if (baris === "/keluar" || baris === "/exit")
-            break;
-        if (!baris) {
-            promptAman();
-            continue;
-        }
-        riwayat.push({ role: "user", content: baris });
-        // Jaga riwayat: buang giliran tertua sampai total token riwayat masuk akal.
-        while (riwayat.length > 2 &&
-            hitungToken(riwayat.map((m) => m.content).join("\n")) > BATAS_TOKEN_RIWAYAT) {
-            riwayat.splice(0, 2);
-        }
-        const hasil = await tanyaRouter({
-            config,
-            messages: [...riwayat],
-            lokasiState: statePath(),
-        });
-        if (hasil.ok) {
-            riwayat.push({ role: "assistant", content: hasil.jawaban });
-            console.log(`\nvibekit (${hasil.provider.nama})> ${hasil.jawaban}\n`);
-        }
-        else {
-            riwayat.pop(); // pertanyaan yang gagal tidak disimpan sebagai giliran selesai
-            console.error(`\n${hasil.pesan}\n`);
-        }
-        promptAman();
     }
-    rl.close();
+    finally {
+        pembaca.tutup();
+    }
     return 0;
 }
 async function perintahDo(args) {
-    const tugas = args.join(" ").trim();
+    const auto = args.includes("--auto") || args.includes("--yes");
+    const tugas = args
+        .filter((a) => a !== "--auto" && a !== "--yes")
+        .join(" ")
+        .trim();
     if (!tugas) {
         console.error("[vibekit] Tugas kosong. Contoh: vibekit do \"buatkan file halo.txt berisi sapaan\"");
         return 2;
@@ -208,15 +324,14 @@ async function perintahDo(args) {
     const cwd = process.cwd();
     console.log(`VibeKit agent — folder kerja: ${cwd}`);
     console.log(`Tugas: ${tugas}`);
-    console.log("Tool baca berjalan langsung; tulis/edit file dan jalankan perintah meminta persetujuanmu satu per satu.\n");
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const konfirmasi = (deskripsi) => new Promise((resolve) => {
-        console.log(`\n[vibekit] Usulan aksi:\n${deskripsi}`);
-        rl.question("Jalankan? (y/N) ", (jawaban) => {
-            const j = jawaban.trim().toLowerCase();
-            resolve(j === "y" || j === "ya");
-        });
-    });
+    if (auto) {
+        cetakPeringatanAuto();
+    }
+    else {
+        console.log("Tool baca berjalan langsung; tulis/edit file dan jalankan perintah meminta persetujuanmu satu per satu.\n");
+    }
+    const pembaca = buatPembacaBaris();
+    const konfirmasi = buatKonfirmasi(pembaca);
     try {
         const hasil = await jalankanAgent({
             config,
@@ -224,6 +339,7 @@ async function perintahDo(args) {
             lokasiState: statePath(),
             cwd,
             konfirmasi,
+            autoAllow: auto,
             jejak: (pesan) => console.error(`[vibekit] ${pesan}`),
         });
         for (const c of hasil.catatan) {
@@ -234,7 +350,7 @@ async function perintahDo(args) {
         return hasil.ok ? 0 : 1;
     }
     finally {
-        rl.close();
+        pembaca.tutup();
     }
 }
 function perintahStatus() {
@@ -274,7 +390,7 @@ async function utama() {
         case "ask":
             return perintahAsk(sisa);
         case "chat":
-            return perintahChat();
+            return perintahChat(sisa);
         case "do":
             return perintahDo(sisa);
         case "status":

package/dist/router.js

@@ -209,7 +209,7 @@ export async function tanyaRouter(opsi) {
         return {
             ok: true,
             jawaban,
-            ...(toolCalls.length > 0 ? { toolCalls } : {}),
+            ...(toolCalls.length > 0 ? { toolCalls, pesanMentah } : {}),
             provider,
             tokenTerpakai,
             tokenSumber,

package/package.json

@@ -15,6 +15,7 @@
   },
   "files": [
     "dist",
+    "scripts",
     "README.md",
     "examples"
   ],
@@ -23,12 +24,13 @@
   "name": "@chispear/vibekit",
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "postinstall": "node scripts/banner.js",
     "prepublishOnly": "npm run build",
     "start": "node dist/cli.js",
     "test": "npm run build && node --test test/*.test.mjs"
   },
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   }

package/scripts/banner.js

@@ -0,0 +1,34 @@
+// Banner CHISPEAR — tampil otomatis setelah package berhasil terpasang
+// (npm postinstall). Tanpa dependensi; hormati NO_COLOR.
+// Salinan mandiri dari seni di src/banner.ts (skrip ini tidak boleh bergantung
+// pada dist/ karena postinstall juga berjalan sebelum build di repo clone) —
+// jaga keduanya tetap sinkron.
+const GLIF = {
+  C: [" █████ ", "██   ██", "██     ", "██     ", "██   ██", " █████ "],
+  H: ["██   ██", "██   ██", "███████", "██   ██", "██   ██", "██   ██"],
+  I: ["███", " █ ", " █ ", " █ ", " █ ", "███"],
+  S: ["███████", "██     ", "██████ ", "     ██", "     ██", "██████ "],
+  P: ["██████ ", "██   ██", "██████ ", "██     ", "██     ", "██     "],
+  E: ["███████", "██     ", "█████  ", "█████  ", "██     ", "███████"],
+  A: [" █████ ", "██   ██", "███████", "██   ██", "██   ██", "██   ██"],
+  R: ["██████ ", "██   ██", "██████ ", "██  ██ ", "██   ██", "██   ██"],
+};
+
+const kata = "CHISPEAR";
+const baris = ["", "", "", "", "", ""];
+for (const huruf of kata) {
+  const g = GLIF[huruf];
+  if (!g) continue;
+  for (let i = 0; i < 6; i++) baris[i] += (baris[i] ? "  " : "") + g[i];
+}
+
+const pakaiWarna = !process.env.NO_COLOR;
+const HIJAU = pakaiWarna ? "\x1b[1;92m" : "";
+const RESET = pakaiWarna ? "\x1b[0m" : "";
+
+console.log("");
+for (const b of baris) console.log(HIJAU + b + RESET);
+console.log("");
+console.log(HIJAU + "  VibeKit CLI terpasang — router AI hemat tokenmu siap dipakai." + RESET);
+console.log("  Mulai dengan: vibekit init   •   Bantuan: vibekit --help");
+console.log("");