luang-cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,367 @@
-# Temporary Holding Version
+# ⚡ luang-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **CLI Agent Orchestration Luang** — hubungkan harness agent coding favoritmu (Claude Code, OpenCode, Codex, Gemini CLI, apapun) ke dashboard **Luang**, kelola tugas dari terminal, jalankan daemon yang memantau progress di kanban, dan eksekusi tugas dengan izin yang dikontrol admin.
+
+![npm](https://img.shields.io/npm/v/luang-cli) ![node](https://img.shields.io/node/v/luang-cli) ![license](https://img.shields.io/npm/l/luang-cli) ![deps](https://img.shields.io/badge/dependencies-0-brightgreen)
+
+```bash
+npm i -g luang-cli
+```
+
+---
+
+## ✨ Kenapa luang-cli?
+
+| Kebutuhan | Solusi luang-cli |
+|---|---|
+| Admin menugaskan coding task dari kanban dashboard | CLI menerima tugas ber-status live (`To-Do → In Progress → Review → Done`) + catatan progress + analytics |
+| Banyak harness berbeda (Claude Code / OpenCode / Codex / Gemini) | Layer **provider** — auto-detect dari config dir / binary di PATH, atau daftar manual |
+| Login tanpa copy-paste token manual | **Device flow**: CLI membuka browser `luang.id` → kamu approve → key diterima CLI otomatis |
+| Integrasi AI assistant lain (bukan lewat terminal) | Server **MCP** (`luang mcp-config`) — 5 tools siap dipakai Claude Code, OpenCode, Cursor, dll |
+| Aman lintas-tenant | Key per-laptop, hash SHA-256 di server, bisa dicabut kapan pun dari dashboard |
+
+- **Zero-dependency**: hanya bawaan Node.js (`fetch`, `node:fs`, `node:readline`, `child_process`) — install cepat, tanpa postinstall.
+- **Node.js ≥ 18** (butuh global `fetch`).
+- API default: `https://api.luang.id` · Dashboard: `https://app.luang.id`
+
+---
+
+## 🗺 Arsitektur
+
+```
+┌─────────────────────┐   device flow (user_code 6 digit)   ┌──────────────────────┐
+│  luang-cli (laptop)  │ ──────────────────────────────────▶ │  app.luang.id         │
+│  bin/luang-cli.js    │ ◀──── api_key (via poll, sekali) ── │  halaman /cli/verify  │
+└─────────┬───────────┘                                     └──────────────────────┘
+          │  X-CLI-Key                                               ▲ JWT browser
+          │  heartbeat 30s · poll tugas 5s                           │
+          ▼                                                          ▼
+┌────────────────────────────────────────────────────────────────────────────┐
+│ api.luang.id  →  modul agent                                                │
+│   device_approvals · agent_keys · agent_providers                           │
+│   tasks(agent_key_id/agent_status/agent_progress_note) · insights           │
+│   POST /api/v1/agent/mcp  ← JSON-RPC 2.0 (MCP tools)                        │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📦 Instalasi
+
+```bash
+# Dari registry npm (recommended, setelah publish)
+npm i -g luang-cli
+
+# Atau dari source repo ini
+git clone https://github.com/yudono/Luang && cd Luang/luang-cli
+npm i -g .          # tanpa dependensi, instan
+
+# Atau run tanpa install
+npx luang-cli help
+```
+
+Cek instalasi:
+
+```bash
+luang-cli help
+luang-cli --version
+```
+
+Upgrade: `npm i -g luang-cli@latest`
+
+---
+
+## 🚀 Quick start (±60 detik)
+
+```bash
+# 1. Login via browser (device flow)
+luang-cli login --name "Laptop Kantor"
+#    → CLI membuka https://app.luang.id/cli/verify?code=123456
+#    → Login dashboard bila perlu → klik "Setujui"
+#    → CLI otomatis menerima key & menyimpannya
+
+# 2. Verifikasi sesi
+luang-cli whoami
+
+# 3. (opsional) daftarkan harness agent di laptop-mu
+luang-cli provider list          # auto-detect
+luang-cli provider default opencode
+
+# 4. Jalanin daemon — lihat tugas update live di terminal
+luang-cli agent
+
+# 5. Dari dashboard: assign tugas ke agent-mu (halaman Agents)
+#    …terminal-mu langsung berisik: TGS-1 versi baru terdeteksi 👀
+luang-cli task list
+luang-cli task status TGS-1 in_progress --note "mulai refactor"
+```
+
+---
+
+## 🔐 Alur login → verify (device flow)
+
+```
+CLI                          API                                  Browser (kamu)
+ │  POST /agent/device/start  │                                      │
+ │ ──────────────────────────▶ │                                      │
+ │  ◀─ device_code + user_code │                                      │
+ │                             │                                      │
+ │  buka verify_url (6 digit)  │                                      │
+ │ ──────────────────────────────────────────────────────────────────▶  │
+ │                             │   GET /agent/device/lookup (JWT)     │
+ │                             │ ◀─────────────────────────────────── │
+ │                             │   klik "Setujui" → agent_keys dibuat │
+ │                             │ ◀─────────────────────────────────── │
+ │  GET /agent/device/poll (2s)│                                      │
+ │ ──────────────────────────▶ │                                      │
+ │  ◀─ {status:"approved",     │                                      │
+ │      api_key:"lk_…"}        │  ← plaintext key dikirim SEKALI,     │
+ │                             │    lalu dihapus dari server          │
+```
+
+- `user_code` 6 digit, sesi kedaluwarsa **10 menit**. Sesi `denied`/`expired` → CLI keluar dengan pesan jelas.
+- Nama sesi default `hostname-OS` — ganti dengan `--name "Laptop Kantor"`.
+- Key dikirim sekali saja (`approved` tanpa `api_key` berarti sudah pernah diambil).
+- Buka browser bisa dimatikan dengan env `LUANG_NO_OPEN=1` (URL tetap dicetak) — pas untuk CI/remote SSH.
+
+### Keamanan
+
+- Server hanya menyimpan **SHA-256** dari key; plaintext tak pernah persist selain window pickup.
+- Key ber-lingkup **tenant + owner** (upload/assign lintas tenant mustahil — repo layer tenant-scoped).
+- Revocation instan dari dashboard (**Agents → Revoke**) — request berikutnya langsung 401.
+
+---
+
+## 🧭 Daftar command
+
+| Command | Fungsi | Contoh |
+|---|---|---|
+| `help` / `--version` | Daftar command / versi | `luang-cli help agent` |
+| `login` | Login device flow via browser | `luang-cli login --name "Laptop Kantor"` |
+| `logout` | Hapus API key tersimpan (`-y` tanpa konfirmasi) | `luang-cli logout -y` |
+| `whoami` | Info sesi: nama, tenant, izin, provider | `luang-cli whoami` |
+| `status` | Ringkasan singkat CLI | `luang-cli status` |
+| `provider list` | Deteksi otomatis + tabel (`--json`) | `luang-cli provider list` |
+| `provider add` | Tambah / override provider config | `luang-cli provider add codex --exec_template 'codex exec "{task}"'` |
+| `provider remove` | Hapus provider dari config | `luang-cli provider remove codex` |
+| `provider default` | Set provider default (dipakai `agent --exec`) | `luang-cli provider default opencode` |
+| `agent` | Daemon: heartbeat + poll tugas live | `luang-cli agent --interval 5 --exec` |
+| `task list` | Daftar tugas agent (filter status) | `luang-cli task list --status todo` |
+| `task create` | Buat tugas (butuh izin admin) | `luang-cli task create --title "Refactor auth" --priority high` |
+| `task status` | Perbarui status + catatan progress | `luang-cli task status TGS-12 in_progress --note "mulai"` |
+| `mcp-config` | Cetak blok konfigurasi MCP siap-tempel | `luang-cli mcp-config` |
+
+Dokumen bantuan per-com: `luang-cli <command> --help` (mis. `luang-cli agent --help`).
+
+### Pemetaan nilai
+
+**Status tugas** (CLI → server kanban):
+
+| CLI token | Kanban dashboard |
+|---|---|
+| `todo` / `to_do` | `To-Do` |
+| `in_progress` / `progress` | `In Progress` |
+| `review` | `Review` |
+| `done` / `completed` | `Done` |
+
+Selain status kanban, bisa kirim **`--agent-status`** (status mesin singkat, mis. `membaca repo`) dan **`--note`** (catatan progress yang tampil di dashboard).
+
+**Prioritas** untuk `task create`: `high` → `Tinggi` · `medium` → `Sedang` · `low` → `Rendah`.
+**Referensi tugas**: pakai kode `TGS-<n>` (mis. `TGS-7`) atau UUID id tugas.
+
+---
+
+## 🛠 Integrasi provider (multi-harness)
+
+Auto-detect (`provider list`):
+
+| Provider | Dari | exec_template default |
+|---|---|---|
+| `claude_code` | `~/.claude` / binary `claude` | `claude -p "{task}"` |
+| `codex` | `~/.codex` / binary `codex` | `codex exec "{task}"` |
+| `opencode` | `~/.config/opencode` / `~/.opencode` / binary `opencode` | `opencode run "{task}"` |
+| `gemini_cli` | `~/.gemini` / binary `gemini` | `gemini -p "{task}"` |
+
+Daftar manual (path khusus, alias brand, multi-provider):
+
+```bash
+luang-cli provider add claude_code --path /opt/homebrew/bin/claude \
+  --exec_template 'claude -p "{task}"'
+luang-cli provider add opencode --exec_template 'opencode run "{task}"'
+luang-cli provider default claude_code
+```
+
+- `{task}` pada template otomatis diganti **judul + deskripsi** tugas; template tanpa `{task}` tidak dipakai mode `--exec`.
+- Daftar provider tersimpan di `~/.luang-cli/config.json` dan disinkron ke server lewat heartbeat (`provider_count` tampil di dashboard Agents).
+
+---
+
+## 🖥 Daemon agent (`luang-cli agent`)
+
+```bash
+luang-cli agent                     # heartbeat tiap 30 detik, poll tugas tiap 5 detik
+luang-cli agent --interval 10       # poll tiap 10 detik
+luang-cli agent --exec              # tertarik juga mengeksekusi tugas To-Do
+```
+
+Perilaku:
+
+1. **Heartbeat** `POST /api/v1/agent/heartbeat` setiap 30 detik (nama + provider list tersinkron; dashboard tampil "Terakhir aktif …").
+2. **Polling** `GET /api/v1/agent/tasks` tiap `--interval` detik — perubahan terdeteksi via fingerprint (status, agent_status, catatan, judul, timestamp) per id tugas.
+3. Baris perubahan dicetak: `[HH:MM:SS] TGS-1  Judul  In Progress  agent=…  note="…"`.
+4. Tugas yang dipindah status di dashboard → tampil live; tugas yang ditugaskan ke agent-mu → masuk daftar.
+
+### Mode `--exec` (semi-otomatis, konfirmasi y/N)
+
+Bila ada tugas `To-Do` yang belum pernah dieksekusi dan default provider punya `exec_template` berisi `{task}`:
+
+1. Konfirmasi `y/N` di terminal — **tidak ada eksekusi diam-diam**.
+2. CLI kirim `{status:"in_progress", agent_status:"menjalankan"}` ke server sebelum menjalankan.
+3. Template dipanggil via `child_process.exec` (shell-safe escaping, timeout **15 menit**, `windowsHide` on).
+4. Hasil:
+   - exit 0 → `{status:"done", agent_status:"selesai", progress_note:"exec exit 0"}`;
+   - exit ≠ 0 → `{status:"review", agent_status:"gagal", progress_note:"exit code <n>"}`.
+5. Riwayat eksekusi disimpan `~/.luang-cli/state.json` — tugas yang sama tidak ditawari dua kali. `Ctrl+C` keluar bersih.
+
+---
+
+## 🎛 Integrasi MCP (tanpa terminal)
+
+Luang juga menyediakan server MCP (JSON-RPC 2.0) di `POST /api/v1/agent/mcp` dengan auth header `X-CLI-Key` — pas untuk Claude Code, OpenCode, Cursor, dll.
+
+Cetak blok konfigurasi siap-tempel:
+
+```bash
+luang-cli mcp-config
+```
+
+```json
+{
+  "mcpServers": {
+    "luang": {
+      "type": "http",
+      "url": "https://api.luang.id/api/v1/agent/mcp",
+      "headers": { "X-CLI-Key": "lk_xxxxxxxx…" }
+    }
+  }
+}
+```
+
+Tools yang tersedia: `luang_list_tasks`, `luang_update_task_status`, `luang_create_task`, `luang_heartbeat`, `luang_me` — reuse service yang sama dengan CLI, jadi izin per key tetap berlaku.
+
+---
+
+## 🔑 Izin agent (dikontrol dari dashboard)
+
+| Aksi CLI | Izin di dashboard | Field backend |
+|---|---|---|
+| `task status`, daemon update | **Bisa-update-tugas** (default ✅) | `can_update_tasks` |
+| `task create` | **Bisa-buat-tugas** (default ❌) | `can_create_tasks` |
+
+Bila `task create` gagal HTTP **403**, minta owner buka **app.luang.id/agents → pilih key → nyalakan \"Bisa-buat-tugas\"**, lalu cek ulang via `luang-cli whoami`.
+
+---
+
+## ⚙️ Konfigurasi
+
+File config auto-dibuat: `~/.luang-cli/config.json`
+
+```json
+{
+  "api_url": "https://api.luang.id",
+  "app_url": "https://app.luang.id",
+  "key": "lk_…",              // hasil login
+  "name": null,               // nama sesi terakhir
+  "default_provider": null,
+  "providers": { "opencode": { "path": "…", "exec_template": "…" } }
+}
+```
+
+State runtime (riwayat terlihat / eksekusi): `~/.luang-cli/state.json`.
+
+| Env | Mempengaruhi |
+|---|---|
+| `LUANG_KEY` | Timpa key tanpa menyentuh config (pas untuk CI) |
+| `LUANG_API_URL` | Timpa `api_url` |
+| `LUANG_APP_URL` | Timpa `app_url` |
+| `LUANG_NO_OPEN` | `login` tidak membuka browser otomatis (cetak URL saja) |
+
+Precedence: **flag `--api <url>` → env → config file**.
+
+---
+
+## 🧯 Troubleshooting
+
+| Gejala | Solusi |
+|---|---|
+| `❌ Belum login` | `luang-cli login`, atau set env `LUANG_KEY` |
+| HTTP 401 di semua command | Key ditolak/dicabut → `luang-cli logout` lalu `login` ulang |
+| HTTP 403 saat `task create` | Admin belum aktifkan izin **Bisa-buat-tugas** (lihat seksi Izin) |
+| `Sesi login kedaluwarsa` | Sesi device flow lewat 10 menit → jalankan `login` lagi |
+| `key sudah pernah diambil` | Browser approve dua kali / poll dijalankan 2× → buat sesi agent baru |
+| Timeout 15 detik | Cek jaringan + `--api https://api.luang.id` |
+| Tabel provider kosong | `provider add <type> --exec_template '…'` manual |
+| `--exec` tak berjalan | Set `provider default <type>` + template harus berisi `{task}` |
+| Daemon boring (tak ada event) | Wajar — ia hanya print KETIKA ada perubahan; coba assign tugas dari dashboard |
+| Mulai bersih total | Hapus `~/.luang-cli/` (config + state) |
+
+---
+
+## 💡 Mengapa dashboard perlu agent ini?
+
+Dengan pasangan **Luang dashboard + luang-cli**, satu workspace bisa:
+
+1. **Orchestrate** banyak user × banyak mesin × banyak harness, dengan kontrol izin per key.
+2. **Kanban + analytics live**: `To-Do / In Progress / Review / Done` per agent + provider count + 5 tugas terakhir (modul **Agents**).
+3. **Fleksibilitas dua jalur**: operasionalisasi lewat CLI, atau tools MCP bagi AI assistantmu.
+
+Baca arsitektur & kontrak API lengkapnya di [`docs/agent-orchestration.md`](../docs/agent-orchestration.md).
+
+---
+
+## 🧪 Development
+
+Struktur repo (folder `luang-cli/` di monorepo [yudono/Luang](https://github.com/yudono/Luang)):
+
+```
+luang-cli/
+├── bin/luang-cli.js    # entrypoint + dispatcher
+├── lib/
+│   ├── core.js         # config, env, HTTP, provider detect, key util
+│   ├── commands.js     # login/logout/whoami/provider
+│   └── agent.js        # daemon, task CRUD, status, mcp-config
+└── package.json        # bin: luang-cli → bin/luang-cli.js
+```
+
+Jalankan dari source:
+
+```bash
+node bin/luang-cli.js help
+node --check bin/luang-cli.js     # sanity sintaks
+```
+
+Publish (owner):
+
+```bash
+cd luang-cli
+npm publish --access public --auth-type=legacy --otp=<kode2FA>
+```
+
+> Versi di `package.json` adalah sumber kebenaran — bump sebelum publish (`npm version patch`).
+
+---
+
+## 🗺 Roadmap
+
+- [ ] MCP tools lanjutan: komentar tugas, subtasks, timesheet
+- [ ] `agent --exec` multi-provider (eksekusi paralel beberapa harness)
+- [ ] Skill installer (Claude Code skill / OpenCode skill yang membungkus luang-cli)
+- [ ] `luang-cli setup` wizard pertama kali (login + provider + tes)
+- [ ] Webhook/SSE realtime (pengganti polling)
+
+---
+
+## 📄 Lisensi
+
+**MIT** — © 2026 Yudono / Luang.
+Link utama: [app.luang.id](https://app.luang.id) · [api.luang.id](https://api.luang.id/health) · [Luang repo](https://github.com/yudono/Luang)

package/bin/luang-cli.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+'use strict';
+
+// bin/luang-cli.js — entry point CLI Luang: parsing argumen, dispatch, help.
+
+const pkg = require('../package.json');
+const core = require('../lib/core');
+const c = require('../lib/commands');
+const ag = require('../lib/agent');
+
+const OVERVIEW = `luang-cli v${pkg.version} — CLI Agent Orchestration Luang
+
+Penggunaan: luang-cli <command> [sub] [opsi]
+
+Command:
+  login       Login device flow via browser        luang-cli login --name "Laptop"
+  logout      Hapus API key tersimpan              luang-cli logout [-y]
+  whoami      Info sesi agent, tenant & izin       luang-cli whoami
+  provider    Kelola provider CLI coding           luang-cli provider list
+  agent       Daemon heartbeat + polling tugas     luang-cli agent [--interval 5] [--exec]
+  task        Kelola tugas (list|create|status)    luang-cli task list
+  status      Ringkasan CLI (key, tenant, izin)    luang-cli status
+  mcp-config  Snippet konfigurasi MCP klien        luang-cli mcp-config
+
+Opsi global:
+  --api <url>   Override URL API (default https://api.luang.id)
+  -h, --help    Bantuan (juga: luang-cli help <command>) · --version
+
+Detail: luang-cli help <command>`;
+
+const TOPICS = {
+  login: `luang-cli login — login via device flow
+
+Penggunaan:
+  luang-cli login [--name <label>]
+
+Opsi:
+  --name <label>   Nama sesi/agent (default: hostname — CLI)
+
+Alur:
+  1. CLI meminta device_code + user_code dari API
+  2. Browser terbuka ke halaman verify (bila gagal, URL cukup dicetak)
+  3. Masukkan user_code di dashboard, klik approve
+  4. API key tersimpan di ~/.luang-cli/config.json
+     "approved" tanpa api_key berarti key sudah pernah diambil sebelumnya.
+
+Contoh:
+  luang-cli login
+  luang-cli login --name "Laptop Kantor"`,
+
+  logout: `luang-cli logout — hapus API key dari ~/.luang-cli/config.json
+
+Penggunaan:
+  luang-cli logout [-y]
+
+Opsi:
+  -y, --yes   Langsung hapus tanpa konfirmasi
+
+Catatan: env LUANG_KEY (bila ter-set) tetap override.`,
+
+  whoami: `luang-cli whoami — info sesi agent dari GET /api/v1/agent/me
+
+Penggunaan:
+  luang-cli whoami
+
+Menampilkan: nama sesi, status, key id, tenant, last seen,
+izin can_update_tasks / can_create_tasks, dan provider terdaftar.`,
+
+  provider: `luang-cli provider — kelola provider CLI coding
+
+Penggunaan:
+  luang-cli provider list [--json]
+      Deteksi otomatis: ~/.claude (claude_code), ~/.codex (codex),
+      ~/.config/opencode atau ~/.opencode (opencode), ~/.gemini (gemini_cli),
+      plus which(1) untuk claude, codex, opencode, gemini.
+      Bila key ada, hasil langsung disinkron via POST /api/v1/agent/heartbeat.
+  luang-cli provider add <type> [--path P] [--exec_template T]
+  luang-cli provider remove <type>
+  luang-cli provider default <type>
+
+Param exec_template:
+  {task} diganti judul + deskripsi tugas saat mode --exec.
+  Contoh: 'claude -p "{task}"', 'opencode run "{task}"', 'codex exec "{task}"'
+
+Contoh:
+  luang-cli provider add opencode --exec_template 'opencode run "{task}"'
+  luang-cli provider default opencode`,
+
+  agent: `luang-cli agent — daemon agent (heartbeat + polling tugas)
+
+Penggunaan:
+  luang-cli agent [--interval N] [--exec]
+
+Opsi:
+  --interval N   Jeda polling GET /api/v1/agent/tasks (detik, default 5)
+  --exec         Eksekusi otomatis tugas "To-Do" yang belum dijalankan
+
+Perilaku:
+  • POST /api/v1/agent/heartbeat tiap 30 detik
+  • Polling GET /api/v1/agent/tasks tiap N detik; baris berubah dicetak:
+      [HH:MM:SS] TGS-1  Judul  In Progress  agent=…  note="…"
+  • State: ~/.luang-cli/state.json
+  • --exec: tugas To-Do + default provider punya exec_template berisi {task}
+    perlu konfirmasi y/N lalu dijalankan; sebelum eksekusi status di-set
+    in_progress, lalu done ("selesai", progress_note "exec selesai") bila
+    exit 0; review ("gagal") bila gagal. exec_template kosong/tanpa {task}
+    → cukup notifikasi satu baris.
+  • Ctrl+C menghentikan daemon dengan bersih.`,
+
+  task: `luang-cli task — kelola tugas
+
+Penggunaan:
+  luang-cli task list [--status todo|in_progress|review|done]
+  luang-cli task create --title "Judul" [--desc "…"] [--priority high|medium|low] [--due 2026-01-02]
+  luang-cli task status <TGS-12|uuid> <todo|in_progress|review|done> [--note "…"] [--agent-status "…"]
+
+Catatan:
+  • task create butuh izin admin "Bisa-buat-tugas" (can_create_tasks)
+  • task status butuh izin "Bisa-update-tugas" (can_update_tasks)
+
+Contoh:
+  luang-cli task list --status todo
+  luang-cli task create --title "Refactor auth" --priority high --due 2026-11-01
+  luang-cli task status TGS-12 in_progress --note "mulai analisis"`,
+
+  status: `luang-cli status — ringkasan CLI
+
+Penggunaan:
+  luang-cli status
+
+Menampilkan: API/App URL, key prefix, tenant, izin,
+default provider & provider lokal, lokasi config/state.`,
+
+  'mcp-config': `luang-cli mcp-config — snippet konfigurasi MCP
+
+Penggunaan:
+  luang-cli mcp-config
+
+Mencetak blok JSON mcpServers untuk klien MCP: endpoint
+POST /api/v1/agent/mcp dengan header X-CLI-Key. Key dipakai dari
+config bila sudah login, selain itu placeholder.`,
+
+  help: OVERVIEW,
+};
+
+// ── Parsing argumen ──────────────────────────────────────────────────────────
+
+const VALUE_FLAGS = new Set([
+  'name', 'path', 'exec_template', 'interval', 'status', 'title', 'desc',
+  'description', 'priority', 'due', 'note', 'agent-status', 'api',
+]);
+
+function parseArgs(argv) {
+  const pos = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--') {
+      for (const x of argv.slice(i + 1)) pos.push(x);
+      break;
+    }
+    if (a.startsWith('--')) {
+      const eq = a.indexOf('=');
+      if (eq > 2) {
+        flags[a.slice(2, eq)] = a.slice(eq + 1);
+        continue;
+      }
+      const name = a.slice(2);
+      const next = argv[i + 1];
+      if (VALUE_FLAGS.has(name) && next !== undefined && !next.startsWith('-')) {
+        flags[name] = next;
+        i++;
+      } else {
+        flags[name] = true;
+      }
+    } else if (a.startsWith('-') && a.length >= 2) {
+      const name = a.slice(1);
+      if (name === 'h') flags.help = true;
+      else flags[name] = true;
+    } else {
+      pos.push(a);
+    }
+  }
+  return { pos, flags };
+}
+
+function printHelp(topic) {
+  const t = TOPICS[topic || 'help'];
+  if (!t) {
+    console.error(`❌ Command tidak dikenal: ${topic}`);
+    console.error('');
+    console.log(OVERVIEW);
+    return 1;
+  }
+  console.log(t);
+  return 0;
+}
+
+// ── Dispatch ─────────────────────────────────────────────────────────────────
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const flags = args.flags;
+  const cmd = args.pos[0];
+
+  if (flags.version === true) {
+    console.log(`luang-cli v${pkg.version}`);
+    return 0;
+  }
+  if (!cmd || flags.help === true) {
+    return printHelp(cmd || 'help');
+  }
+  if (cmd === 'help') {
+    return printHelp(args.pos[1] || 'help');
+  }
+
+  const rt = core.resolveRuntime(core.loadConfig(), flags);
+  switch (cmd) {
+    case 'login':
+      return c.cmdLogin(rt, args);
+    case 'logout':
+      return c.cmdLogout(rt, args);
+    case 'whoami':
+      return c.cmdWhoami(rt, args);
+    case 'provider':
+      return c.cmdProvider(rt, args);
+    case 'agent':
+      return ag.cmdAgent(rt, args);
+    case 'task':
+      return ag.cmdTask(rt, args);
+    case 'status':
+      return ag.cmdStatus(rt, args);
+    case 'mcp-config':
+      return ag.cmdMcpConfig(rt, args);
+    default: {
+      console.error(`❌ Command tidak dikenal: ${cmd}`);
+      console.error('   Jalankan `luang-cli help` untuk daftar command.');
+      return 1;
+    }
+  }
+}
+
+main()
+  .then((code) => process.exit(code === undefined ? 0 : code))
+  .catch((e) => {
+    console.error(`❌ ${e && e.message ? e.message : e}`);
+    process.exit(1);
+  });