@joyihub/cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @joyihub/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[有亦工坊 JoYiHub](https://joyihub.thebinwang.com/) 创作者套件官方 NPM 分发包。
+
+## 快速使用
+
+无需繁琐配置，智能体或创作者可在终端一键运行：
+
+```bash
+npx @joyihub/cli agent install
+```
+
+该命令将：
+1. 自动根据当前操作系统下载匹配的高性能静态二进制；
+2. 为你的 AI 编码智能体（Cursor、Claude Code、Windsurf、OpenCode、Codex 等）安装并注册三大官方 Skill：
+   - [joyihub-project-prepare](https://github.com/BingoWon/joyihub/tree/main/cli/skills/joyihub-project-prepare): 作品接入要求与可选外部资源推荐，不分发第三方技能内容
+   - `joyihub-capabilities`: 平台能力与横竖屏适配
+   - `joyihub-publish`: 自动化打包、预览与发布
+
+## 全局安装
+
+```bash
+npm install -g @joyihub/cli
+```
+
+安装后即可直接使用 `joyihub` 命令：
+
+```bash
+joyihub --version
+joyihub capabilities
+joyihub agent doctor
+```
+
+## 支持平台
+
+- macOS (Apple Silicon arm64)
+- macOS (Intel x64)
+- Linux (x64)
+- Linux (arm64)
+- Windows (x64)

package/bin/joyihub.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export function resolveBinary() {
+	if (process.env.JOYIHUB_BINARY_PATH && fs.existsSync(process.env.JOYIHUB_BINARY_PATH)) {
+		return process.env.JOYIHUB_BINARY_PATH;
+	}
+
+	const platform = process.platform;
+	const arch = process.arch;
+	const isWindows = platform === "win32";
+	const binaryName = isWindows ? "joyihub.exe" : "joyihub";
+
+	const platformKey = `${platform}-${arch}`;
+	const validPlatforms = [
+		"darwin-arm64",
+		"darwin-x64",
+		"linux-x64",
+		"linux-arm64",
+		"win32-x64",
+	];
+
+	if (!validPlatforms.includes(platformKey)) {
+		console.error(
+			`[joyihub] Unsupported platform/architecture: ${platformKey}. Supported: ${validPlatforms.join(", ")}`,
+		);
+		process.exit(1);
+	}
+
+	const subpackageName = `@joyihub/cli-${platformKey}`;
+
+	// Candidate search paths:
+	const candidatePaths = [
+		// 1. Sibling inside same scope (node_modules/@joyihub/cli-darwin-arm64/bin/joyihub or dist/packages/@joyihub/...)
+		path.join(__dirname, "..", "..", `cli-${platformKey}`, "bin", binaryName),
+		// 2. Relative node_modules inside current package
+		path.join(__dirname, "..", "node_modules", subpackageName, "bin", binaryName),
+		// 3. Root node_modules (pnpm/flat layout)
+		path.join(__dirname, "..", "..", "..", subpackageName, "bin", binaryName),
+		// 4. Dist directory layout during local development
+		path.join(__dirname, "..", "dist", "packages", subpackageName, "bin", binaryName),
+		// 5. Direct fallback alongside runner
+		path.join(__dirname, binaryName),
+	];
+
+	for (const candidate of candidatePaths) {
+		try {
+			if (fs.existsSync(candidate)) {
+				return candidate;
+			}
+		} catch {
+			// ignore stat errors
+		}
+	}
+
+	// Try resolving using import.meta.resolve
+	try {
+		const resolvedPackageJson = import.meta.resolve(`${subpackageName}/package.json`);
+		const packageDir = path.dirname(fileURLToPath(resolvedPackageJson));
+		const resolvedBin = path.join(packageDir, "bin", binaryName);
+		if (fs.existsSync(resolvedBin)) {
+			return resolvedBin;
+		}
+	} catch {
+		// package not found
+	}
+
+	console.error(
+		`[joyihub] Could not find executable binary for ${subpackageName}.\n` +
+			`Please make sure the optional dependency "${subpackageName}" was installed successfully.\n` +
+			`You can try reinstalling via: npm install -g @joyihub/cli`,
+	);
+	process.exit(1);
+}
+
+export function runJoYiHub(args = process.argv.slice(2)) {
+	const binaryPath = resolveBinary();
+
+	const child = spawn(binaryPath, args, {
+		stdio: "inherit",
+		env: process.env,
+	});
+
+	const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+	for (const signal of signals) {
+		process.on(signal, () => {
+			if (!child.killed) {
+				child.kill(signal);
+			}
+		});
+	}
+
+	child.on("exit", (code, signal) => {
+		if (signal) {
+			process.kill(process.pid, signal);
+		} else {
+			process.exit(code ?? 0);
+		}
+	});
+
+	child.on("error", (error) => {
+		console.error(`[joyihub] Failed to launch ${binaryPath}:`, error.message);
+		process.exit(1);
+	});
+}
+
+// If executed directly as a script (support symlinks such as .bin/joyihub)
+function isMain() {
+	if (!process.argv[1]) return false;
+	try {
+		return fs.realpathSync(process.argv[1]) === fs.realpathSync(fileURLToPath(import.meta.url));
+	} catch {
+		return path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+	}
+}
+
+if (isMain()) {
+	runJoYiHub();
+}
+

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@joyihub/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "JoYiHub Creator CLI & Agent Skills - Official Distribution",
+  "type": "module",
+  "bin": {
+    "joyihub": "bin/joyihub.js"
+  },
+  "main": "bin/joyihub.js",
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BingoWon/joyihub.git",
+    "directory": "cli/npm"
+  },
+  "keywords": [
+    "joyihub",
+    "game-development",
+    "ai-agent",
+    "cli"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@joyihub/cli-darwin-arm64": "0.2.0",
+    "@joyihub/cli-darwin-x64": "0.2.0",
+    "@joyihub/cli-linux-x64": "0.2.0",
+    "@joyihub/cli-linux-arm64": "0.2.0",
+    "@joyihub/cli-win32-x64": "0.2.0"
+  }
+}