docs(cli): clarify hidden .kilo install artifact behavior

2026-09-21 05:52:35 +08:00 · 2026-03-03 11:56:32 +09:00
parent b9e62056eb
commit 307043c303
2 changed files with 74 additions and 0 deletions
@@ -0,0 +1,64 @@
+// kilocode_change - new file
+import { describe, expect, test } from "bun:test"
+import { $ } from "bun"
+import fs from "fs/promises"
+import os from "os"
+import path from "path"
+
+const root = path.join(import.meta.dir, "..", "..")
+const wrapper = path.join(root, "bin", "kilo")
+
+describe("npm install artifact behavior", () => {
+  test("keeps the CLI wrapper contract", async () => {
+    const text = await fs.readFile(wrapper, "utf8")
+    expect(text.startsWith("#!/usr/bin/env node")).toBe(true)
+    expect(text).toContain("const envPath = process.env.KILO_BIN_PATH")
+    expect(text).toContain("const base = \"@kilocode/cli-\" + platform + \"-\" + arch")
+    expect(text).toContain("function findBinary(startDir)")
+  })
+
+  test("links npm bin commands to the wrapper during local install", async () => {
+    const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "kilo-install-artifact-"))
+    const pkg = path.join(tmp, "pkg")
+    const bin = path.join(pkg, "bin")
+    const prefix = path.join(tmp, "prefix")
+    await fs.mkdir(bin, { recursive: true })
+    await fs.mkdir(prefix, { recursive: true })
+    await fs.copyFile(wrapper, path.join(bin, "kilo"))
+    await Bun.write(
+      path.join(pkg, "package.json"),
+      JSON.stringify(
+        {
+          name: "kilo-install-artifact-repro",
+          version: "1.0.0",
+          bin: {
+            kilo: "./bin/kilo",
+            kilocode: "./bin/kilo",
+          },
+        },
+        null,
+        2,
+      ),
+    )
+
+    await $`npm install --prefix ${prefix} ${pkg} --no-package-lock --ignore-scripts --no-audit --no-fund`.quiet()
+
+    const commands = ["kilo", "kilocode"]
+    for (const name of commands) {
+      const link = path.join(prefix, "node_modules", ".bin", name)
+      const stat = await fs.lstat(link)
+      expect(stat.isSymbolicLink() || stat.isFile()).toBe(true)
+    }
+
+    const hidden = path.join(prefix, "node_modules", ".bin", ".kilo")
+    const exists = await fs
+      .access(hidden)
+      .then(() => true)
+      .catch(() => false)
+    if (!exists) return
+
+    const stat = await fs.lstat(hidden)
+    expect(stat.isFile() || stat.isSymbolicLink()).toBe(true)
+    if (!stat.isSymbolicLink()) expect(stat.size).toBeGreaterThan(0)
+  })
+})