luang-cli 0.3.0 → 0.3.2

package/README.md

@@ -146,7 +146,11 @@ CLI                          API                                  Browser (kamu)
 | `provider remove` | Hapus provider dari config | `luang-cli provider remove codex` |
 | `provider default` | Set provider default (dipakai `agent --exec`) | `luang-cli provider default opencode` |
 | `telemetry` | Konsent kirim data usage/model (`on\|off\|status`) | `luang-cli telemetry status` |
-| `agent` | Daemon **realtime WS** + heartbeat + polling (fallback) | `luang-cli agent --exec` |
+| `agent` | Daemon **realtime WS** + background/auto + polling (fallback) | `luang-cli agent start` |
+| `models` | Daftar model AI per provider (deteksi dinamis + saran) | `luang-cli models opencode` |
+| `workspace` | Folder kerja provider (sinkron dashboard), dipakai cwd `--exec` | `luang-cli workspace ~/project` |
+| `agent start` | Jalankan daemon di **background** (mode auto, log + pid file) | `luang-cli agent start` |
+| `agent stop\|status\|logs` | Hentikan (SIGTERM) · status (pid/uptime/log) · tail log | `luang-cli agent logs --tail 50` |
 | `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"` |
@@ -199,14 +203,50 @@ luang-cli provider default opencode
 
 ---
 
+## 🧩 Daftar model (`luang-cli models`)
+
+```bash
+luang-cli models                    # semua provider (tabel)
+luang-cli models opencode           # satu provider saja
+luang-cli models --json             # untuk mesin: {<provider>: {provider, source, models}}
+```
+
+- **Sumber (berurutan)**: dinamis **hanya** untuk `opencode` — coba perintah `opencode models`, gagal → parse `~/.config/opencode/` atau `~/.opencode`, gagal juga → registry statis. Provider lain selalu registry statis per harness (saran/datalist; versi lama tidak masalah — model tetap bisa diketik manual).
+- **Kebijakan ketat**: binary `claude`, `gemini`, dan `codex` **tidak pernah dieksekusi**.
+- Tabel: `Provider | Jumlah model | daftar` (wrap maks 6 baris + `…+n lagi`); `--json` untuk konsumsi mesin.
+- Field `models` (maks 50 item, tiap ≤120 karakter) ikut dikirim ke server pada heartbeat dan hello frame WS.
+
+---
+
 ## 🖥 Daemon agent (`luang-cli agent`)
 
 ```bash
 luang-cli agent                     # realtime WS (heartbeat + push tugas); fallback polling bila WS gagal
 luang-cli agent --interval 10       # (mode fallback) poll tiap 10 detik
 luang-cli agent --exec              # eksekusi tugas To-Do (konfirmasi y/N)
+
+# Background — terminal boleh ditutup
+luang-cli agent start               # spawn detached → ~/.luang-cli/agent.log + agent.pid (mode AUTO)
+luang-cli agent start --no-auto     # background tanpa eksekusi (monitor saja)
+luang-cli agent status              # pid · uptime · mode auto/manual · 3 baris log terakhir
+luang-cli agent logs --tail 50      # tail log (default 30 baris)
+luang-cli agent stop                # SIGTERM graceful + hapus agent.pid
+```
+
+**Mode auto** (`agent start`, default): tugas `To-Do` yang di-assign ke key ini **langsung dieksekusi tanpa konfirmasi y/N** (karena tidak ada terminal) — termasuk event realtime `task.assigned`. Pilihan ini disimpan ke `config.json → auto_exec` dan ditampilkan oleh `agent status`. Foreground `agent` / `agent --exec` tetap memakai konfirmasi y/N seperti biasa.
+
+### Workspace folder (`luang-cli workspace`)
+
+Folder kerja tempat provider dijalankan (mis. repo yang dikerjakan `opencode`). Diatur dari **dashboard** (Detail Agent → Workspace Folder) **atau** CLI — server adalah sumber kebenaran, CLI menyalin ke config lokal:
+
+```bash
+luang-cli workspace              # tampilkan server/lokal/efektif
+luang-cli workspace ~/project    # simpan (validasi folder harus ada)
+luang-cli workspace --reset      # kosongkan → exec pakai folder saat ini
 ```
 
+Dipakai sebagai **cwd** saat `--exec`/`agent start` menjalankan provider (baris `Folder : …` di log eksekusi). Folder tidak ada → warning + fallback ke folder saat ini.
+
 **Mode utama: realtime WebSocket** (`/api/v1/agent/ws`, auth `X-CLI-Key`) — tugas di-assign dari dashboard langsung ter-push ke terminal tanpa polling. **Fallback**: bila WS gagal (jaringan/proxy/Node lama), otomatis turun ke polling HTTP seperti versi lama — daemon tetap hidup, tidak crash.
 
 Perilaku (kedua mode):
@@ -239,6 +279,32 @@ Bila ada tugas `To-Do` yang belum pernah dieksekusi dan default provider punya `
 5. Setelah selesai, event **`telemetry.run`** (started/completed/failed + provider/model/durasi/exit_code) dikirim **hanya bila konsent telemetry aktif** (lihat bawah).
 6. Riwayat eksekusi disimpan `~/.luang-cli/state.json` — tugas yang sama tidak ditawari dua kali. `Ctrl+C` keluar bersih.
 
+### Background + mode otomatis (`agent start`)
+
+Terminal boleh ditutup — daemon jalan di background:
+
+```bash
+luang-cli agent start          # background + mode auto (eksekusi To-Do TANPA konfirmasi y/N)
+luang-cli agent start --no-auto # background tapi hanya memantau (tanpa eksekusi)
+luang-cli agent status          # pid, uptime, mode, 3 baris log terakhir
+luang-cli agent logs --tail 50 # isi log
+luang-cli agent stop            # hentikan (SIGTERM graceful)
+```
+
+- Child ditulis ke `~/.luang-cli/agent.pid` (`{pid, started_at, auto, mode}`), log ke `~/.luang-cli/agent.log`.
+- Mode auto: tugas To-Do yang di-assign ke key ini langsung dieksekusi (termasuk via event realtime `task.assigned`); default provider + template `{task}` tetap dipakai seperti `--exec`.
+- Foreground (`luang-cli agent` / `--exec`) tetap seperti dulu — konfirmasi y/N, cocok untuk percobaan manual.
+
+### Daftar model (`luang-cli models`)
+
+```bash
+luang-cli models               # semua provider: jumlah + daftar (wrap 6 baris)
+luang-cli models opencode      # satu provider
+luang-cli models --json        # mesin
+```
+
+Urutan sumber: **deteksi dinamis** (untuk opencode: perintah/config lokal bila tersedia) → **registry saran statis** per provider → ketik manual selalu bisa. Hasil sync ke server (heartbeat/hello) sehingga dashboard bisa menampilkan saran model di Detail Agent. Kebijakan: binary `claude`/`gemini`/`codex` **tidak pernah dieksekusi** untuk deteksi (hanya opencode yang aman + parse file config).
+
 ---
 
 ## 📡 Telemetry (ops-in, konsent ganda)
@@ -315,12 +381,14 @@ File config auto-dibuat: `~/.luang-cli/config.json`
   "key": "lk_…",              // hasil login
   "name": null,               // nama sesi terakhir
   "telemetry": false,         // konsent lokal telemetry (default OFF)
+  "auto_exec": false,         // mode auto agent (ditulis `agent start [--no-auto]`)
   "default_provider": null,
   "providers": { "opencode": { "path": "…", "exec_template": "…", "model": "sonnet-4" } }
 }
 ```
 
 State runtime (riwayat terlihat / eksekusi): `~/.luang-cli/state.json`.
+Daemon background: `~/.luang-cli/agent.pid` (JSON `{pid, started_at, auto, mode}`) + `~/.luang-cli/agent.log`.
 
 | Env | Mempengaruhi |
 |---|---|
@@ -348,6 +416,9 @@ Precedence: **flag `--api <url>` → env → config file**.
 | 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}` |
+| Pesan "eksekusi nonaktif" | Normal tanpa `--exec` — nyalakan dengan `luang-cli agent --exec` atau `luang-cli agent start` (mode auto) |
+| `agent start` langsung mati | Cek `luang-cli agent logs` (biasanya belum `login`) |
+| `agent status` bilang "pid file basi" | Proses sudah mati → `luang-cli agent stop` untuk membersihkan |
 | Menunggu `{model}` (tugas ditunda) | `provider add <type> --model <m>` · env `LUANG_MODEL` · atau set_model dari dashboard |
 | Daemon tak realtime (polling) | Wajar bila WS gagal — cek `LUANG_NO_WS`, proxy/firewall port WS; polling tetap jalan |
 | Telemetry tak terkirim | Butuh konsent **ganda**: `luang-cli telemetry on` + toggle server di dashboard Agents |
@@ -378,12 +449,13 @@ luang-cli/
 ├── lib/
 │   ├── core.js         # config, env, HTTP, provider detect, key util
 │   ├── ws.js           # klien WebSocket RFC 6455 (zero-dep) utk mode realtime
-│   ├── commands.js     # login/logout/whoami/telemetry/provider
-│   └── agent.js        # daemon realtime+fallback, task CRUD, status, mcp-config
+│   ├── models.js       # registry model statis + deteksi aman (hanya opencode)
+│   ├── commands.js     # login/logout/whoami/telemetry/provider/models
+│   └── agent.js        # daemon realtime+fallback (foreground & background), task CRUD, status, mcp-config
 ├── test/
-│   ├── run-e2e.js      # E2E offline (61 assertion): realtime, fallback, konsent, model
+│   ├── run-e2e.js      # E2E offline (151 assertion): realtime, fallback, konsent, model, lifecycle
 │   ├── ws-stub.js      # stub server WS (RFC 6455) utk uji offline
-│   ├── http-stub.js    # stub HTTP /agent/me (di-fork, IPC) utk uji konsent
+│   ├── http-stub.js    # stub HTTP /agent/me + /agent/heartbeat (di-fork, IPC)
 │   └── bin/opencode    # stub binary provider (tidak pernah panggil claude/gemini asli)
 └── package.json        # bin: luang-cli → bin/luang-cli.js
 ```

package/bin/luang-cli.js

@@ -18,7 +18,9 @@ Command:
   whoami      Info sesi agent, tenant & izin       luang-cli whoami
   provider    Kelola provider CLI coding           luang-cli provider list
   telemetry   Konsent telemetry on|off|status      luang-cli telemetry status
-  agent       Daemon realtime WS + polling tugas   luang-cli agent [--exec]
+  workspace   Folder kerja provider (sinkron dash) luang-cli workspace [path|--reset]
+  agent       Daemon realtime WS + polling tugas   luang-cli agent [--exec] · start|stop|status|logs
+  models      Daftar model AI per provider          luang-cli models [provider] [--json]
   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
@@ -104,10 +106,30 @@ Perilaku:
     realtime (started/completed/failed saat exec) — pakai header X-CLI-Key, bukan JWT.
   • Satu flag mati → CLI tidak pernah mengirim data run (server juga men-drop).`,
 
-  agent: `luang-cli agent — daemon realtime (WebSocket) + fallback polling
+  workspace: `luang-cli workspace — folder kerja provider (sinkron dashboard ↔ CLI)
 
 Penggunaan:
-  luang-cli agent [--interval N] [--exec]
+  luang-cli workspace              tampilkan server/lokal/efektif + validasi folder
+  luang-cli workspace <path>       simpan ke server (POST /agent/workspace) + lokal
+  luang-cli workspace --reset      kosongkan (exec memakai folder saat ini)
+
+Perilaku:
+  • Server adalah sumber kebenaran (dashboard Agents → Detail → Workspace Folder);
+    CLI menyalin ke config lokal saat hello.ok / status / whoami.
+  • Nilai dipakai sebagai cwd saat --exec (spawn provider). Folder tidak ada /
+    bukan direktori → warning + fallback ke folder saat ini.
+  • Bentuk path: absolut (/x/y), home (~/x), atau relatif (terhadap cwd).`,
+
+  agent: `luang-cli agent — daemon realtime (WebSocket) + fallback polling
+
+Penggunaan (foreground):
+  luang-cli agent [--interval N] [--exec] [--auto]
+
+Penggunaan (background):
+  luang-cli agent start [--no-auto] [--auto]   spawn detached → ~/.luang-cli/agent.log
+  luang-cli agent stop                         SIGTERM + hapus ~/.luang-cli/agent.pid
+  luang-cli agent status                       pid · uptime · mode · 3 baris log terakhir
+  luang-cli agent logs [--tail N]              tail log (default 30 baris)
 
 Mode:
   1) Realtime WebSocket (utama): wss://<api>/api/v1/agent/ws, auth header
@@ -130,11 +152,53 @@ Opsi:
      exit 0 → done/"selesai"; gagal → review/"gagal exit N".
      Tiap run juga mengirim telemetry.run started/completed/failed
      (consent: telemetry on + flag server ON).
+  --auto         Mode otomatis: doExec=true TANPA konfirmasi y/N (dipakai
+     anak proses \`agent start\`; foreground juga boleh memakai).
+
+Background (\`agent start\`):
+  • spawn detached (stdio → ~/.luang-cli/agent.log, unref) + tulis
+    ~/.luang-cli/agent.pid berisi JSON {pid, started_at, auto, mode}.
+  • Default = mode AUTO: eksekusi tugas To-Do begitu terdeteksi (termasuk
+    event realtime task.assigned) tanpa y/N — karena tidak ada terminal.
+    \`--no-auto\` mematikan (monitor saja, eksekusi nonaktif).
+  • Pilihan ini ditulis ke config auto_exec (config.json) dan ditampilkan
+    oleh \`agent status\`.
+  • \`agent stop\` kirim SIGTERM (jalur shutdown sama dengan Ctrl+C) lalu
+    hapus pid file; \`agent status\` cek process.kill(pid,0) + uptime.
+  • Tanpa --exec dan tanpa mode auto → tugas hanya diberi tahu sekali:
+    "eksekusi nonaktif (jalankan \`luang-cli agent --exec\` atau \`agent start\`
+    untuk mode otomatis)" — TIDAK menyalahkan exec_template.
 
 Perilaku:
   • State: ~/.luang-cli/state.json · Ctrl+C keluar bersih.
   • Heartbeat HTTP fallback tiap 30 detik (override: LUANG_HEARTBEAT_SEC).`,
 
+  models: `luang-cli models — daftar model AI per provider
+
+Penggunaan:
+  luang-cli models [provider] [--json]
+
+Provider: claude_code | codex | opencode | gemini_cli | custom
+  (tanpa argumen = semua provider)
+
+Sumber data (berurutan):
+  1. Dinamis — HANYA opencode: coba perintah \`opencode models\`, bila tidak
+     ada/ gagal → parse config ~/.config/opencode/ atau ~/.opencode.
+     KEBIJAKAN KETAT: binary claude / gemini / codex TIDAK PERNAH dijalankan.
+  2. Registry statis = saran per harness (versi lama tidak masalah — ini
+     datalist; user tetap bisa mengetik model manual).
+
+Tampilan: tabel Provider | Jumlah model | daftar (wrap maks 6 baris +
+"…+n lagi"). \`--json\` untuk mesin: {<provider>: {provider, source, models}}.
+
+Catatan: field \`models\` (maks 50 item, tiap ≤120 karakter) juga dikirim ke
+server pada heartbeat dan hello frame WS.
+
+Contoh:
+  luang-cli models
+  luang-cli models opencode
+  luang-cli models --json`,
+
   task: `luang-cli task — kelola tugas
 
 Penggunaan:
@@ -176,6 +240,7 @@ config bila sudah login, selain itu placeholder.`,
 const VALUE_FLAGS = new Set([
   'name', 'path', 'exec_template', 'interval', 'status', 'title', 'desc',
   'description', 'priority', 'due', 'note', 'agent-status', 'api', 'model',
+  'tail',
 ]);
 
 function parseArgs(argv) {
@@ -254,8 +319,12 @@ async function main() {
       return c.cmdProvider(rt, args);
     case 'telemetry':
       return c.cmdTelemetry(rt, args);
+    case 'workspace':
+      return c.cmdWorkspace(rt, args);
     case 'agent':
       return ag.cmdAgent(rt, args);
+    case 'models':
+      return c.cmdModels(rt, args);
     case 'task':
       return ag.cmdTask(rt, args);
     case 'status':