@ywldan/karsa 0.1.0 → 0.1.2

package/README.md

@@ -5,7 +5,7 @@
 **"Ember in the terminal"** — agentic coding CLI berbasis Rust yang ringan,
 dengan TUI fullscreen, daemon multi-sesi, dan keamanan berlapis.
 
-`v0.1.0` · Rust 2024 · workspace 17 crate · semua teks UI Bahasa Indonesia
+`v0.1.2` · Rust 2024 · workspace 17 crate · semua teks UI Bahasa Indonesia
 
 </div>
 
@@ -18,7 +18,7 @@ binary `target/release/karsa`):
 
 ```text
  karsa  default · mock                                                      ctx 0% ·  · - t/s · 0s ·
-ℹ ▚▞ karsa v0.1.0 — ketik prompt; `/` palette; Ctrl+C 2× keluar           TODO  FILES  PLAN  MCP  TAB
+ℹ ▚▞ karsa v0.1.2 — ketik prompt; `/` palette; Ctrl+C 2× keluar           TODO  FILES  PLAN  MCP  TAB
                                                                         ────────────────────────────
 ℹ mcp: 1 server aktif — 1 terhubung, 0 gagal (rincian `/mcp`)
 ╭ /cmd · ⏎ kirim · ⇧⏎ antri · ↑ riwayat ───────────────────────────────────────────────────────────╮
@@ -57,6 +57,34 @@ Silahkan lihat dokumen lengkap spesifikasi di [`KARSA-BUILD.md`](KARSA-BUILD.md)
 | **karsa-sdk** | protokol NDJSON versi 1 (`hello/ping/turn/stop/message/broadcast/sessions/swarm/bye`) + client async + `karsa sdk schema` |
 | **Slash commands** | **68 perintah tepat terdaftar** (≥ 58 syarat §15.3) dengan metadata (alias, argumen, summary, help, scope); yang belum tersedia tampil `not-implemented` — tidak pernah senyap |
 
+## Pasang
+
+```bash
+# npm (Linux x64 & Windows x64)
+npm install -g @ywldan/karsa
+karsa --version
+
+# dari sumber
+cargo build --release -p karsa-cli   # biner: target/release/karsa
+```
+
+Paket npm utama hanya berisi wrapper Node (`bin/karsa.js`); biner aslinya datang
+lewat `optionalDependencies` per platform — `@ywldan/karsa-linux-x64`,
+`@ywldan/karsa-win32-x64` — jadi yang terunduh hanya biner untuk OS/arsitektur
+kamu. Kalau paket platform tidak tersedia (mis. arm64 atau macOS), wrapper
+berhenti dengan pesan jelas, bukan gagal senyap. Bisa ditimpa dengan env
+`KARSA_BIN=/jalur/ke/karsa`.
+
+Mengemas + menerbitkan rilis npm: `./scripts/npm-pack.sh` (stage + `npm pack` ke
+`dist/`) lalu `./scripts/npm-pack.sh --publish`. Biner Windows di-cross-compile
+dari Linux (`x86_64-pc-windows-gnu`) dan hanya bergantung pada DLL bawaan
+Windows — tanpa libgcc/winpthread.
+
+> **Windows:** TUI, `run`, `config`, `provider`, `sessions`, `mcp`, `skills`
+jalan normal. `karsa daemon` / `karsa daemon-server` **tidak** tersedia di
+Windows karena transport-nya unix socket — arm-nya di-cfg-out dan CLI memberi
+pesan eksplisit; pakai WSL kalau butuh daemon multi-sesi.
+
 ## Mulai cepat
 
 ```bash

package/bin/karsa.js

@@ -1,34 +1,86 @@
 #!/usr/bin/env node
-const { execSync } = require('child_process');
-const path = require('path');
-const os = require('os');
-const fs = require('fs');
+// Wrapper npm untuk biner `karsa`.
+//
+// Kenapa file ini ada: npm tidak bisa memasang biner Rust langsung, jadi paket
+// utama hanya membawa biner untuk platform yang terpasang lewat
+// `optionalDependencies` (@ywldan/karsa-<platform>-<arch>). Wrapper ini memilih
+// biner yang cocok lalu meneruskan seluruh argv + exit code.
+//
+// Catatan penting: JANGAN pernah menimpa `__dirname`/`require` di file ini.
+// Node >= 22.7 mendeteksi ulang modul saat kompilasi CommonJS gagal dan
+// menjatuhkannya ke mode ESM, yang membuat `require` hilang:
+//   "ReferenceError: require is not defined in ES module scope"
+'use strict';
 
-const platform = os.platform();
-const arch = os.arch();
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
 
-let binaryName = 'karsa';
-if (platform === 'win32') {
-  binaryName += '.exe';
-}
-
-// Determine the directory where this script resides
-const __dirname = path.dirname(process.mainModule.filename);
-const binaryPath = path.join(__dirname, '..', binaryName);
+const EXE = process.platform === 'win32' ? 'karsa.exe' : 'karsa';
+const PLATFORM = `${process.platform}-${process.arch}`;
+const PKG_ROOT = path.resolve(__dirname, '..');
+const SUB_PKG = `@ywldan/karsa-${PLATFORM}`;
 
-// If the binary exists next to the script (in the package root), run it
-if (fs.existsSync(binaryPath)) {
+function isFile(p) {
   try {
-    execSync(`"${binaryPath}" ${process.argv.slice(2).join(' ')}`, { stdio: 'inherit' });
-  } catch (e) {
-    process.exit(e.code);
+    return Boolean(p) && fs.statSync(p).isFile();
+  } catch {
+    return false;
+  }
+}
+
+// Kandidat lokasi biner, dari yang paling spesifik ke paling umum.
+function candidates() {
+  const list = [];
+  if (process.env.KARSA_BIN) {
+    list.push(process.env.KARSA_BIN);
   }
-} else {
-  // Fallback: try to run from PATH (in case user installed globally via other means)
+  // 1. Dependensi platform (jalur normal).
   try {
-    execSync(`${binaryName} ${process.argv.slice(2).join(' ')}`, { stdio: 'inherit' });
-  } catch (e) {
-    console.error(`Karsa binary not found. Please install it via cargo install karsa-cli or download a release from GitHub.`);
-    process.exit(1);
+    const dir = path.dirname(require.resolve(`${SUB_PKG}/package.json`));
+    list.push(path.join(dir, EXE));
+  } catch {
+    // optionalDependency tidak terpasang; lanjut ke fallback.
+  }
+  // 2. Layout npm/yarn/pnpm yang di-hoist.
+  list.push(path.join(PKG_ROOT, '..', SUB_PKG.split('/')[1], EXE));
+  // 3. Biner yang dibundel di paket utama (layout lama, <= 0.1.1).
+  list.push(path.join(PKG_ROOT, EXE));
+  return list;
+}
+
+function resolveBinary() {
+  for (const c of candidates()) {
+    if (isFile(c)) return c;
   }
+  return null;
+}
+
+const binary = resolveBinary();
+
+if (!binary) {
+  process.stderr.write(
+    [
+      `karsa: biner untuk ${PLATFORM} tidak ditemukan.`,
+      `  Coba pasang ulang:  npm install -g @ywldan/karsa`,
+      `  Rilis praterkompilasi: https://github.com/ywildan/karsa-cli-landing/releases`,
+      `  Bangun dari sumber:   cargo install --path crates/karsa-cli  (atau cargo build --release -p karsa-cli)`,
+      '',
+    ].join('\n'),
+  );
+  process.exit(1);
+}
+
+// spawnSync dengan array argumen: tanpa shell, jadi argumen ber-spasi/kutip
+// diteruskan utuh (execSync + interpolasi string akan merusaknya).
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit' });
+
+if (result.error) {
+  process.stderr.write(`karsa: gagal menjalankan ${binary}: ${result.error.message}\n`);
+  process.exit(1);
+}
+if (result.signal) {
+  // Biner dihentikan sinyal: tiru perilaku terminal.
+  process.kill(process.pid, result.signal);
 }
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@ywldan/karsa",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Karsa - Rust agentic coding CLI",
   "bin": {
     "karsa": "./bin/karsa.js"
   },
   "files": [
-    "bin/",
-    "README.md",
-    "karsa"
+    "bin/"
   ],
+  "optionalDependencies": {
+    "@ywldan/karsa-linux-x64": "0.1.2",
+    "@ywldan/karsa-win32-x64": "0.1.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },