ailoom-cli 0.0.0-draft

package/PLATFORMS.md

@@ -0,0 +1,17 @@
+# 平台矩阵（npm 包装器）
+
+| OS | Arch | 三元组 | 状态 |
+|---|---|---|---|
+| macOS (darwin) | arm64 / x64 | aarch64-apple-darwin | 设计支持（发布前验证） |
+| Linux | x64 / arm64 | x86_64 / aarch64-unknown-linux-gnu | 设计支持（发布前验证） |
+| Windows | x64 | x86_64-pc-windows-msvc | 设计支持（发布前验证） |
+
+## 下载与离线
+
+- 制品：`{BASE}/{version}/ailoom-{version}-{三元组}[.exe]` + 同名 `.sha256`
+- `AILOOM_DOWNLOAD_BASE` 可指向内网镜像；完全离线环境手动放置二进制到 `~/.ailoom/bin/`
+- 校验：安装前 sha256 必须匹配 `.sha256`；失败拒绝运行
+
+## 版本对应
+
+- npm 包版本与 Rust crate 版本一一对应（release workflow 由 Cargo.toml tag 触发并注入 VERSION 文件）

package/cli.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+/**
+ * AILoom npm 包装器（设计稿 v0，AIL-029）。
+ * 职责：定位/下载平台匹配的 ailoom 二进制 → sha256 校验 → 透传参数。
+ * 状态：设计稿。发布与下载 URL 由 release workflow 落地后接线（docs/RELEASE-CHECKLIST.md）。
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync } from "node:fs";
+import { homedir, platform, arch } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const BASE_URL = process.env.AILOOM_DOWNLOAD_BASE ?? "https://example.invalid/ailoom/releases";
+const VERSION = "0.0.0-draft";
+
+function triple() {
+  const p = platform();
+  const a = arch();
+  if (p === "darwin") return "aarch64-apple-darwin";
+  if (p === "linux" && a === "x64") return "x86_64-unknown-linux-gnu";
+  if (p === "linux" && a === "arm64") return "aarch64-unknown-linux-gnu";
+  if (p === "win32" && a === "x64") return "x86_64-pc-windows-msvc";
+  fail(`不支持的平台 ${p}/${a}；矩阵见 packaging/npm/PLATFORMS.md`);
+}
+
+function fail(message) {
+  console.error(`[ailoom] ${message}`);
+  console.error("诊断：代理环境设置 HTTPS_PROXY / AILOOM_DOWNLOAD_BASE（离线镜像）；");
+  console.error("或手动下载二进制放入 ~/.ailoom/bin/。详见 packaging/npm/PLATFORMS.md。");
+  process.exit(1);
+}
+
+function binaryPath() {
+  const ext = platform() === "win32" ? ".exe" : "";
+  const dir = process.env.AILOOM_BIN_DIR ?? join(homedir(), ".ailoom", "bin");
+  return join(dir, `ailoom-${triple()}${ext}`);
+}
+
+function verifySha256(file, expectedFile) {
+  // 校验清单与制品同源发布；缺失或失败即拒绝运行
+  if (!existsSync(expectedFile)) fail(`缺少校验文件，拒绝运行未校验制品`);
+  const expected = readFileSync(expectedFile, "utf8").trim().split(/\s+/)[0];
+  const actual = createHash("sha256").update(readFileSync(file)).digest("hex");
+  if (actual !== expected) fail(`制品校验失败（sha256 不匹配）`);
+}
+
+function main() {
+  const bin = binaryPath();
+  if (!existsSync(bin)) {
+    // 设计稿：下载逻辑由 release workflow 落地后接线（download → verify → rename → chmod）
+    fail(
+      `未找到二进制 ${bin}。\n设计稿尚未接线下载；请在 AILOOM_BIN_DIR 放置对应平台二进制。`
+    );
+  }
+  verifySha256(bin, `${bin}.sha256`);
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  process.exit(result.status ?? 1);
+}
+
+if (process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop())) {
+  mkdirSync(join(homedir(), ".ailoom", "bin"), { recursive: true });
+  main();
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "ailoom-cli",
+  "version": "0.0.0-draft",
+  "description": "AILoom npm wrapper: locates and runs the platform ailoom binary (no Rust toolchain required)",
+  "license": "Apache-2.0",
+  "bin": {
+    "ailoom": "./cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": ["cli.js", "PLATFORMS.md"],
+  "repository": {
+    "type": "git",
+    "url": "https://example.invalid/ailoom"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}