@gbits-jszx/gw-cli 0.2.0

package/README.md

@@ -0,0 +1,48 @@
+# @gbits-jszx/gw-cli
+
+GW-Framework 的跨平台构建、运行和交付工具。公网 registry 为 `https://registry.npmjs.org/`，包内包含 Windows amd64 和 Linux amd64（含 WSL）二进制。
+
+打包过程和最终 `.tgz` 全部位于仓库根目录 `.gw-build/npm/`；源码目录不会生成 `bin/native` 或被 `npm version` 改写。
+
+## 使用
+
+首次发布成功后，在 GW-Framework 项目根目录执行：
+
+```powershell
+npx -y --prefer-online @gbits-jszx/gw-cli@latest --version
+npx -y --prefer-online @gbits-jszx/gw-cli@latest doctor
+npx -y --prefer-online @gbits-jszx/gw-cli@latest build all
+npx -y --prefer-online @gbits-jszx/gw-cli@latest run all
+# 另开终端
+npx -y --prefer-online @gbits-jszx/gw-cli@latest test all
+```
+
+`build`、`run`、`test` 统一接受 `core|mock|web|all`，`all` 只包含三个 app。`build`、`run` 需要源码和 Go，`run` 还需要 Docker（Windows 默认走 WSL）。npm 发布使用当前平台 npm；镜像命令优先使用当前平台 Docker，Windows 缺少 Docker 时转 WSL；Chart 推送在 Windows 默认走 WSL，可用 `--wsl=false` 切换。平台能力由 `doctor` 输出。
+
+## 发布凭据
+
+```powershell
+npx -y --prefer-online @gbits-jszx/gw-cli@latest publish npm --version 0.2.1
+npx -y --prefer-online @gbits-jszx/gw-cli@latest publish image --tag 0.2.1-dev
+npx -y --prefer-online @gbits-jszx/gw-cli@latest publish chart --version 0.2.1
+```
+
+缺少 npm Token 或 Harbor Robot 账号/密码时，CLI 会询问并自动保存到 `~/jszx-infra/.gw-cli/config.yaml`；可用 `GW_CLI_CONFIG` 覆盖位置。已有配置不重复询问。命令参数、`NODE_AUTH_TOKEN` / `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD` 优先于用户配置。
+
+Token 和密码在终端中不回显。配置文件保存明文凭据，Unix 下目录/文件权限为 0700/0600，Windows 使用用户目录 ACL。网关服务不读取此文件。
+
+## 首次发布与本地验证
+
+2026-09-09 查询公网 `@gbits-jszx/gw-cli` 返回 404；首次发布前直接运行源码 CLI：
+
+```powershell
+go run ./tools/cli npm package --version 0.2.0
+npx -y --package ./.gw-build/npm/gbits-jszx-gw-cli-0.2.0.tgz gw-cli --version
+npx -y --package ./.gw-build/npm/gbits-jszx-gw-cli-0.2.0.tgz gw-cli build all
+# 只检查发布包，不上传、不询问 Token
+go run ./tools/cli publish npm --dry-run
+# 真正发布：输入具备 @gbits-jszx/gw-cli 发布权限的 npm Token
+go run ./tools/cli publish npm --version 0.2.0
+```
+
+发布后的版本号不可复用。这里的 `gw-cli` 是包内命令名，公网下载始终使用 scoped 包 `@gbits-jszx/gw-cli`。

package/bin/gw-cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawn, spawnSync } = require('node:child_process');
+
+const platform = process.platform === 'win32' ? 'windows' : process.platform;
+const arch = process.arch === 'x64' ? 'amd64' : process.arch === 'arm64' ? 'arm64' : process.arch;
+const extension = process.platform === 'win32' ? '.exe' : '';
+const binary = path.join(__dirname, 'native', `gw-cli-${platform}-${arch}${extension}`);
+
+if (!fs.existsSync(binary)) {
+  console.error(`gw-cli does not ship a binary for ${platform}/${arch}`);
+  process.exit(1);
+}
+
+// npm may extract tarballs created on Windows without the executable bit.
+// The package directory is user-owned, so repair it before spawning on Unix.
+if (process.platform !== 'win32') {
+  try { fs.chmodSync(binary, 0o755); } catch (error) {
+    console.error(`cannot prepare gw-cli binary: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+// Keep the native process in the console group so Ctrl+C reaches the Go
+// supervisor and its deferred container/process cleanup runs on Windows.
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit', windowsHide: false });
+
+// Keep the wrapper alive while the native CLI stops its services and database.
+// Windows console events already reach the child; child.kill('SIGINT') on
+// Windows would force-terminate it and skip Go's deferred cleanup.
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => {
+    if (process.platform !== 'win32') child.kill(signal);
+  });
+}
+child.on('error', (error) => {
+  console.error(error.message);
+  process.exit(1);
+});
+child.on('exit', (code) => {
+  // Run after the child exits; invoking Docker while a Windows Ctrl+C event is
+  // active can interrupt the cleanup subprocess itself.
+  // A test/build/publish in another terminal must not remove run all's DB.
+  if (process.argv[2] === 'run' && process.argv[3] === 'all') {
+    spawnSync(binary, ['cleanup'], { stdio: 'inherit', windowsHide: false });
+  }
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "bin": {
+    "gw-cli": "bin/gw-cli.js"
+  },
+  "description": "GW-Framework build, publish and k3s delivery CLI",
+  "engines": {
+    "node": "\u003e=18"
+  },
+  "files": [
+    "bin"
+  ],
+  "license": "MIT",
+  "name": "@gbits-jszx/gw-cli",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "version": "0.2.0"
+}