@aegean-org/necode-cli 1.0.0 → 1.0.2

package/README.md

@@ -13,7 +13,7 @@ npm install -g @aegean-org/necode-cli
 necode
 ```
 
-包发布在 npm registry，包名是 `@aegean-org/necode-cli`，安装后的命令是 `necode`。这是一个集成 CLI 包，安装时会从公开的 `liangwei/necode-cli-releases` GitHub Releases 下载当前平台二进制；普通用户不需要安装 Bun，也不需要单独安装内部 `pi-*` 包。
+包发布在 npm registry，包名是 `@aegean-org/necode-cli`，安装后的命令是 `necode`。这是一个集成 CLI 包，首次运行 `necode` 时会从公开的 `liangwei/necode-cli-releases` GitHub Releases 下载当前平台二进制；普通用户不需要安装 Bun，也不需要单独安装内部 `pi-*` 包。
 
 ### 登录
 
@@ -68,7 +68,7 @@ npm install -g @aegean-org/necode-cli
 necode
 ```
 
-The package is published to the npm registry as `@aegean-org/necode-cli`, and the installed command is `necode`. It is an integrated CLI package; install downloads the matching platform binary from the public `liangwei/necode-cli-releases` GitHub Releases, so normal users do not need Bun or separate internal `pi-*` packages.
+The package is published to the npm registry as `@aegean-org/necode-cli`, and the installed command is `necode`. It is an integrated CLI package; the first `necode` run downloads the matching platform binary from the public `liangwei/necode-cli-releases` GitHub Releases, so normal users do not need Bun or separate internal `pi-*` packages.
 
 ### Login
 

package/bin/necode.js

@@ -1,36 +1,13 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
+import { installBinary } from "../scripts/install-integrated-binary.js";
 
 const FAILURE_EXIT_CODE = 1;
 const SUCCESS_EXIT_CODE = 0;
 const USER_ARGV_OFFSET = 2;
-const BINARIES = Object.freeze({
-	"darwin-arm64": "necode-cli-darwin-arm64",
-	"darwin-x64": "necode-cli-darwin-x64",
-	"linux-arm64": "necode-cli-linux-arm64",
-	"linux-x64": "necode-cli-linux-x64",
-	"win32-x64": "necode-cli-windows-x64.exe",
-});
 
-function resolveBinary() {
-	const key = `${process.platform}-${process.arch}`;
-	const binaryName = BINARIES[key];
-	if (!binaryName) {
-		throw new Error(`Unsupported platform: ${key}`);
-	}
-	const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-	const binaryPath = path.join(packageRoot, "binaries", binaryName);
-	if (!fs.existsSync(binaryPath)) {
-		throw new Error(`Installed necode binary is missing: ${binaryPath}. Reinstall without --ignore-scripts.`);
-	}
-	return binaryPath;
-}
-
-function run() {
-	const binaryPath = resolveBinary();
+async function run() {
+	const binaryPath = await installBinary();
 	const result = spawnSync(binaryPath, process.argv.slice(USER_ARGV_OFFSET), {
 		stdio: "inherit",
 		windowsHide: false,
@@ -46,7 +23,7 @@ function run() {
 }
 
 try {
-	run();
+	await run();
 } catch (error) {
 	const message = error instanceof Error ? error.message : String(error);
 	process.stderr.write(`error: ${message}\n`);

package/binary-manifest.json

@@ -1,31 +1,31 @@
 {
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"repository": "liangwei/necode-cli-releases",
 	"assets": {
 		"darwin-arm64": {
 			"filename": "necode-cli-darwin-arm64",
-			"sha256": "210cfe0ca226da82e3fab887b93ff7173af88ca7e7310b509340ee4f1c61592c",
+			"sha256": "521c2e6d6d40faf86edd32009f42ea548831c7370382d25e0ca626b858ed82ae",
 			"size": 201537632
 		},
 		"darwin-x64": {
 			"filename": "necode-cli-darwin-x64",
-			"sha256": "dbad795f958ab25880adffa69a2ef40aa10d4012b776a75374a5c6e963c14c9c",
+			"sha256": "162e1d67d961d920509f4ee323d581506b5bccdde418b130f1fb17f3f4f98bb6",
 			"size": 206981312
 		},
 		"linux-arm64": {
 			"filename": "necode-cli-linux-arm64",
-			"sha256": "264eb62fd60083e7a7f1bbf5834acd90eab2728712c6629a9ab38404105df0ab",
+			"sha256": "42bbcc30a37a19a10c14c3e5ae4144e4eded32fa7553316f27a79c28312cc4dd",
 			"size": 227387536
 		},
 		"linux-x64": {
 			"filename": "necode-cli-linux-x64",
-			"sha256": "aaa36b9f039077c39d771af3906df68cdef7f01ee06675861e778133ab4cb944",
-			"size": 243677312
+			"sha256": "242581942463faafd74412b724ff2822e040ec23ec3666c1dc94ce6139e552f5",
+			"size": 243681408
 		},
 		"win32-x64": {
 			"filename": "necode-cli-windows-x64.exe",
-			"sha256": "4f09f4336ff11d019395d21a595540eb964dd0fb6f05e85539ab389169ba86c6",
-			"size": 231872000
+			"sha256": "ca892f5a0d47180e1cf49c3fdd8efbb47de8eaeb5139441753986f6ee213056b",
+			"size": 231874048
 		}
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aegean-org/necode-cli",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "necode coding agent with read, bash, edit, write tools and session management",
 	"author": "Can Boluk",
 	"contributors": [
@@ -30,9 +30,6 @@
 	"engines": {
 		"node": ">=18"
 	},
-	"scripts": {
-		"postinstall": "node scripts/install-integrated-binary.js"
-	},
 	"os": [
 		"darwin",
 		"linux",

package/scripts/install-integrated-binary.js

@@ -1,19 +1,22 @@
 #!/usr/bin/env node
 import { createHash } from "node:crypto";
+import { once } from "node:events";
 import * as fs from "node:fs";
 import * as fsp from "node:fs/promises";
+import * as os from "node:os";
 import * as path from "node:path";
-import { Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
+import { finished } from "node:stream/promises";
 import { fileURLToPath } from "node:url";
 
 const EXECUTABLE_MODE = 0o755;
 const FAILURE_EXIT_CODE = 1;
+const BYTES_PER_MIB = 1024 * 1024;
+const PERCENT_SCALE = 100;
 const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 const manifestPath = path.join(packageRoot, "binary-manifest.json");
-const binariesDir = path.join(packageRoot, "binaries");
+const CACHE_DIR_NAME = "necode-cli";
 
-async function readManifest() {
+export async function readManifest() {
 	const manifest = JSON.parse(await fsp.readFile(manifestPath, "utf8"));
 	if (typeof manifest.version !== "string") throw new Error("binary-manifest.json is missing version");
 	if (typeof manifest.repository !== "string") throw new Error("binary-manifest.json is missing repository");
@@ -21,7 +24,7 @@ async function readManifest() {
 	return manifest;
 }
 
-function resolveAsset(manifest) {
+export function resolveAsset(manifest) {
 	const platformKey = `${process.platform}-${process.arch}`;
 	const asset = manifest.assets[platformKey];
 	if (!asset) {
@@ -33,6 +36,16 @@ function resolveAsset(manifest) {
 	return asset;
 }
 
+function resolveCacheRoot() {
+	if (process.platform === "win32") return process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+	if (process.platform === "darwin") return path.join(os.homedir(), "Library", "Caches");
+	return process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
+}
+
+export function resolveBinaryPath(manifest, asset) {
+	return path.join(resolveCacheRoot(), CACHE_DIR_NAME, manifest.version, asset.filename);
+}
+
 function releaseAssetUrl(manifest, asset) {
 	const tag = `v${manifest.version}`;
 	return `https://github.com/${manifest.repository}/releases/download/${tag}/${asset.filename}`;
@@ -46,21 +59,59 @@ async function sha256File(filePath) {
 	return hash.digest("hex");
 }
 
+async function fileExists(filePath) {
+	try {
+		const stat = await fsp.stat(filePath);
+		return stat.isFile();
+	} catch (error) {
+		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return false;
+		throw error;
+	}
+}
+
+function formatBytes(bytes) {
+	return `${(bytes / BYTES_PER_MIB).toFixed(1)} MiB`;
+}
+
+function reportProgress(downloaded, totalBytes) {
+	if (totalBytes > 0) {
+		const percent = ((downloaded / totalBytes) * PERCENT_SCALE).toFixed(1);
+		process.stderr.write(`\rDownloading necode binary: ${formatBytes(downloaded)} / ${formatBytes(totalBytes)} (${percent}%)`);
+		return;
+	}
+	process.stderr.write(`\rDownloading necode binary: ${formatBytes(downloaded)}`);
+}
+
 async function downloadFile(url, outputPath) {
 	const response = await fetch(url);
 	if (!response.ok) throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
 	if (!response.body) throw new Error(`Failed to download ${url}: response body is empty`);
-	await pipeline(Readable.fromWeb(response.body), fs.createWriteStream(outputPath, { mode: EXECUTABLE_MODE }));
+	const totalBytes = Number(response.headers.get("content-length")) || 0;
+	const output = fs.createWriteStream(outputPath, { mode: EXECUTABLE_MODE });
+	const reader = response.body.getReader();
+	let downloaded = 0;
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		downloaded += value.byteLength;
+		if (!output.write(value)) await once(output, "drain");
+		reportProgress(downloaded, totalBytes);
+	}
+	output.end();
+	await finished(output);
+	process.stderr.write("\n");
 }
 
-async function installBinary() {
+export async function installBinary() {
 	const manifest = await readManifest();
 	const asset = resolveAsset(manifest);
-	const finalPath = path.join(binariesDir, asset.filename);
+	const finalPath = resolveBinaryPath(manifest, asset);
 	const tmpPath = `${finalPath}.tmp-${process.pid}`;
-	await fsp.mkdir(binariesDir, { recursive: true });
+	if (await fileExists(finalPath)) return finalPath;
+	await fsp.mkdir(path.dirname(finalPath), { recursive: true });
 	await fsp.rm(tmpPath, { force: true });
 	try {
+		process.stderr.write(`Installing necode ${manifest.version} binary for ${process.platform}-${process.arch}\n`);
 		await downloadFile(releaseAssetUrl(manifest, asset), tmpPath);
 		const actualSha256 = await sha256File(tmpPath);
 		if (actualSha256 !== asset.sha256) {
@@ -71,12 +122,15 @@ async function installBinary() {
 	} finally {
 		await fsp.rm(tmpPath, { force: true });
 	}
+	return finalPath;
 }
 
-try {
-	await installBinary();
-} catch (error) {
-	const message = error instanceof Error ? error.message : String(error);
-	process.stderr.write(`error: ${message}\n`);
-	process.exit(FAILURE_EXIT_CODE);
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+	try {
+		await installBinary();
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`error: ${message}\n`);
+		process.exit(FAILURE_EXIT_CODE);
+	}
 }