@kairainy/ck 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# `@kairainy/ck`
+
+npm wrapper cho binary **`ck`** (Code Knowledge Graph CLI).  
+Scope npm: org **`kairainy`** (không phải `@codeknowledge` — org đó chưa có trên npm).
+
+## Cài đặt
+
+```bash
+npm i -g @kairainy/ck
+ck --help
+ck --version
+```
+
+Khi chưa có release trên host:
+
+```bash
+# từ Individual/code-knowledge
+cargo build -p code-knowledge --release
+CK_CLI_USE_LOCAL=1 npm i -g ./packaging/npm/@codeknowledge/cli
+```
+
+## Env
+
+| Biến | Mô tả |
+|---|---|
+| `CK_CLI_USE_LOCAL=1` | Copy `target/release/ck(.exe)` từ monorepo |
+| `CK_RELEASE_BASE` | Base URL kiểu `…/releases` |
+| `CK_CLI_BINARY_URL` | URL archive đầy đủ |
+
+Chi tiết: [docs/install/cli.md](../../../../docs/install/cli.md).

package/bin/ck.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * Thin launcher: runs platform binary next to this file (installed by postinstall).
+ */
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const isWin = process.platform === "win32";
+const binName = isWin ? "ck.exe" : "ck";
+const binPath = path.join(__dirname, binName);
+
+if (!fs.existsSync(binPath)) {
+  console.error(
+    `[ck] Binary missing at ${binPath}. Re-run: npm i -g @kairainy/ck\n` +
+      `Or for local dev: CK_CLI_USE_LOCAL=1 npm i -g ./packaging/npm/@codeknowledge/cli`
+  );
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: true,
+});
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@kairainy/ck",
+  "version": "0.1.0",
+  "description": "npm wrapper for the Code Knowledge Graph CLI (ck)",
+  "license": "UNLICENSED",
+  "bin": {
+    "ck": "bin/ck.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://codeknowledge.io.vn"
+  },
+  "keywords": [
+    "code-knowledge",
+    "ck",
+    "cli",
+    "mcp",
+    "kairainy"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,162 @@
+"use strict";
+
+/**
+ * Download (or copy local) `ck` binary for this platform into bin/.
+ *
+ * Env:
+ *   CK_CLI_USE_LOCAL=1  — copy from repo target/release (dev)
+ *   CK_RELEASE_BASE     — release base URL (GitHub-style .../releases)
+ *   CK_CLI_BINARY_URL   — full URL override for the archive
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const https = require("node:https");
+const http = require("node:http");
+const { execFileSync } = require("node:child_process");
+const { createWriteStream } = require("node:fs");
+const { pipeline } = require("node:stream/promises");
+
+const pkg = require("../package.json");
+const version = pkg.version;
+const binDir = path.join(__dirname, "..", "bin");
+const isWin = process.platform === "win32";
+const binName = isWin ? "ck.exe" : "ck";
+const dest = path.join(binDir, binName);
+
+function rustTarget() {
+  const plat = process.platform;
+  const arch = process.arch;
+  let rustArch;
+  if (arch === "x64") rustArch = "x86_64";
+  else if (arch === "arm64") rustArch = "aarch64";
+  else throw new Error(`Unsupported arch: ${arch}`);
+
+  if (plat === "win32") return `${rustArch}-pc-windows-msvc`;
+  if (plat === "darwin") return `${rustArch}-apple-darwin`;
+  if (plat === "linux") return `${rustArch}-unknown-linux-gnu`;
+  throw new Error(`Unsupported platform: ${plat}`);
+}
+
+function findRepoRoot() {
+  // packaging/npm/@codeknowledge/cli/scripts → repo root = 5 levels up
+  return path.resolve(__dirname, "..", "..", "..", "..", "..");
+}
+
+function copyLocal() {
+  const root = findRepoRoot();
+  const local = path.join(root, "target", "release", binName);
+  if (!fs.existsSync(local)) {
+    throw new Error(
+      `CK_CLI_USE_LOCAL=1 but missing ${local}. Run: cargo build -p code-knowledge --release`
+    );
+  }
+  fs.mkdirSync(binDir, { recursive: true });
+  fs.copyFileSync(local, dest);
+  if (!isWin) fs.chmodSync(dest, 0o755);
+  console.log(`[ck] Installed local binary → ${dest}`);
+}
+
+function download(url, outFile) {
+  return new Promise((resolve, reject) => {
+    const mod = url.startsWith("https") ? https : http;
+    const req = mod.get(url, (res) => {
+      if (
+        res.statusCode >= 300 &&
+        res.statusCode < 400 &&
+        res.headers.location
+      ) {
+        res.resume();
+        download(res.headers.location, outFile).then(resolve, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        res.resume();
+        return;
+      }
+      const file = createWriteStream(outFile);
+      pipeline(res, file).then(resolve, reject);
+    });
+    req.on("error", reject);
+  });
+}
+
+async function downloadRelease() {
+  const target = rustTarget();
+  const base =
+    process.env.CK_RELEASE_BASE ||
+    "https://github.com/kai-rainy/code-knowledge/releases";
+  const archive = isWin
+    ? `ck-${target}.zip`
+    : `ck-${target}.tar.gz`;
+  const url =
+    process.env.CK_CLI_BINARY_URL ||
+    `${base}/download/v${version}/${archive}`;
+
+  const tmpDir = fs.mkdtempSync(path.join(require("node:os").tmpdir(), "ck-npm-"));
+  const archivePath = path.join(tmpDir, archive);
+
+  console.log(`[ck] Downloading ${url}`);
+  try {
+    await download(url, archivePath);
+  } catch (e) {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    throw new Error(
+      `${e.message}\n` +
+        `No release asset yet? Use local: CK_CLI_USE_LOCAL=1 npm i -g ./packaging/npm/@codeknowledge/cli\n` +
+        `Or: cargo install --path apps/cli --force`
+    );
+  }
+
+  fs.mkdirSync(binDir, { recursive: true });
+  try {
+    if (isWin) {
+      execFileSync(
+        "powershell.exe",
+        [
+          "-NoProfile",
+          "-Command",
+          `Expand-Archive -Path '${archivePath.replace(/'/g, "''")}' -DestinationPath '${tmpDir.replace(/'/g, "''")}' -Force`,
+        ],
+        { stdio: "inherit" }
+      );
+    } else {
+      execFileSync("tar", ["-xzf", archivePath, "-C", tmpDir], {
+        stdio: "inherit",
+      });
+    }
+    const found = walkFind(tmpDir, binName);
+    if (!found) throw new Error(`${binName} not found in archive`);
+    fs.copyFileSync(found, dest);
+    if (!isWin) fs.chmodSync(dest, 0o755);
+    console.log(`[ck] Installed → ${dest}`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+function walkFind(dir, name) {
+  for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, ent.name);
+    if (ent.isDirectory()) {
+      const hit = walkFind(p, name);
+      if (hit) return hit;
+    } else if (ent.name === name) {
+      return p;
+    }
+  }
+  return null;
+}
+
+async function main() {
+  if (process.env.CK_CLI_USE_LOCAL === "1") {
+    copyLocal();
+    return;
+  }
+  await downloadRelease();
+}
+
+main().catch((err) => {
+  console.error(`[ck] postinstall failed: ${err.message}`);
+  process.exit(1);
+});