luang-cli 0.3.3 → 0.3.5

package/README.md

@@ -151,6 +151,7 @@ CLI                          API                                  Browser (kamu)
 | `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` |
+| `start` / `stop` / `logs` | Alias top-level ala PM2 → `agent …` (`status` tetap ringkasan CLI) | `luang-cli start` |
 | `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"` |

package/bin/luang-cli.js

@@ -20,6 +20,9 @@ Command:
   telemetry   Konsent telemetry on|off|status      luang-cli telemetry status
   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
+  start       Alias: agent start (background)      luang-cli start [--no-auto]
+  stop        Alias: agent stop                    luang-cli stop
+  logs        Alias: agent logs                    luang-cli logs [--tail 50]
   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
@@ -278,6 +281,8 @@ function parseArgs(argv) {
 }
 
 function printHelp(topic) {
+  // Alias top-level start/stop/logs → dokumentasi di topik agent.
+  if (topic === 'start' || topic === 'stop' || topic === 'logs') topic = 'agent';
   const t = TOPICS[topic || 'help'];
   if (!t) {
     console.error(`❌ Command tidak dikenal: ${topic}`);
@@ -321,6 +326,12 @@ async function main() {
       return c.cmdTelemetry(rt, args);
     case 'workspace':
       return c.cmdWorkspace(rt, args);
+    // Alias gaya PM2: start/stop/logs top-level → subcommand agent.
+    // (status TIDAK dialias — tetap ringkasan CLI; pakai `agent status`.)
+    case 'start':
+    case 'stop':
+    case 'logs':
+      return ag.cmdAgent(rt, { ...args, pos: ['agent', cmd] });
     case 'agent':
       return ag.cmdAgent(rt, args);
     case 'models':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luang-cli",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "CLI Agent Orchestration Luang — login device flow, sinkronisasi provider AI, daemon tugas, dan manajemen task dari terminal. Zero-dependency, Node >= 18.",
   "license": "MIT",
   "bin": {

package/test/run-e2e.js

@@ -781,6 +781,35 @@ async function scenarioWorkspace() {
   console.log('    ✅ Skenario workspace selesai');
 }
 
+// ── Skenario 9: alias top-level start/stop/logs (+ help) ──
+async function scenarioAliases() {
+  console.log('\n[9] alias start/stop/logs → subcommand agent (+ help start)');
+  const home = mkFakeHome('alias');
+  writeJson(path.join(home, '.luang-cli', 'config.json'), {
+    api_url: 'http://127.0.0.1:9',
+    app_url: 'http://127.0.0.1',
+    key: 'lk_test_e2e_alias',
+    default_provider: null,
+    providers: {},
+  });
+  const env = { ...daemonEnv(home), LUANG_HEARTBEAT_SEC: undefined };
+
+  // stop/logs tanpa daemon → pesan ramah, exit 0 (bukti delegasi ke cmdAgent jalan)
+  let r = runCli(env, ['stop']);
+  assert(r.code === 0 && r.stdout.includes('Agent tidak berjalan'), 'alias stop → agent stop (tidak berjalan, exit 0)');
+  r = runCli(env, ['logs']);
+  assert(r.code === 0 && r.stdout.includes('Log belum ada'), 'alias logs → agent logs (belum ada, exit 0)');
+  // help start → topik agent
+  r = runCli(env, ['help', 'start']);
+  assert(r.code === 0 && r.stdout.includes('luang-cli agent'), 'help start → menampilkan topik agent');
+  // status TIDAK dialias (tetap ringkasan CLI)
+  r = runCli(env, ['status']);
+  assert(r.code === 0 && r.stdout.includes('Status luang-cli'), 'status tetap ringkasan CLI (bukan agent status)');
+
+  passCount += 1;
+  console.log('    ✅ Skenario alias selesai');
+}
+
 // ── main ──
 async function main() {
   console.log(`E2E luang-cli — fakir HOME: ${baseTmp}`);
@@ -792,6 +821,7 @@ async function main() {
   await scenarioAgentLifecycle();
   await scenarioModels();
   await scenarioWorkspace();
+  await scenarioAliases();
   console.log(`\nSEMIUA PASS ✅ (${passCount} assertion)`);
 }