omnicrawl-cli 0.1.68

package/README.md

@@ -0,0 +1,63 @@
+# omnicrawl-cli
+
+OmniCrawl 启动器：按 `platform-arch` 选包node_modules的内核二进制，把 stdio 转交给它。
+它不做协议转换——宿主直接与内核进程对话（协议见 `rust/docs/protocol-v1.md`）。
+
+## 分发形态
+
+| npm 包 | 内容 |
+| --- | --- |
+| `omnicrawl-cli` | JS 启动器（`bin/omnicrawl.mjs`） |
+| `@omnicrawl/cli-linux-x64` | 内核二进制（Linux x64，musl 静态） |
+| `@omnicrawl/cli-linux-arm64-musl` | 内核二进制（Linux arm64，嵌入式目标） |
+| `@omnicrawl/cli-win32-x64` | 内核二进制（Windows x64） |
+
+**平台分包、`os`/`cpu` 与平台依赖只出现在发布产物里**（`dist/npm/`）。仓库内的 `packages/cli*/package.json`
+刻意不带 `os`/`cpu`、也不声明平台分包依赖：npm 安装时会校验工作区成员的 `os`/`cpu`，带上就直接
+`notsup` 失败。发布产物由 `scripts/prepare.mjs` 生成。
+
+## 本地开发
+
+```bash
+cargo build --release -p omnicrawl-cli      # 产物：rust/target/release/omnicrawl[.exe]
+node packages/cli/scripts/prepare.mjs       # 暂存发布产物（缺的平台只警告）
+npm test -w omnicrawl-cli                  # e2e：真二进制 + 协议 v1
+OMNICRAWL_BINARY=/path/to/omnicrawl node packages/cli/bin/omnicrawl.mjs --version
+```
+
+工作区里 `@omnicrawl/cli-*` 都是 workspace 成员，启动器靠 `createRequire` 解析到它们；
+`OMNICRAWL_BINARY` 是直接指定二进制的逃生口（e2e 用的就是它）。e2e 需要 `rust/target/release`
+里有产物，否则跳过并打印构建命令。
+
+## 发布
+
+1. 交叉编译三个平台（Linux 走 musl 静态，嵌入式目标优先）：
+
+   ```bash
+   cargo build --release -p omnicrawl-cli --target x86_64-pc-windows-msvc
+   cargo build --release -p omnicrawl-cli --target x86_64-unknown-linux-musl
+   cargo build --release -p omnicrawl-cli --target aarch64-unknown-linux-musl
+   ```
+
+2. 门槛检查（缺任何平台会失败并列出缺失平台）：
+
+   ```bash
+   node packages/cli/scripts/prepare.mjs --require-all
+   ```
+
+3. 按顺序发布暂存产物：平台包在前，启动器在后（启动器的 `optionalDependencies` 是精确版本，顺序反了会装不到）：
+
+   ```bash
+   npm publish dist/npm/cli-linux-x64
+   npm publish dist/npm/cli-linux-arm64-musl
+   npm publish dist/npm/cli-win32-x64
+   npm publish dist/npm/cli
+   ```
+
+   脚本跑完会把这几行命令直接打出来。
+
+4. 版本reproducibility：四个包同版本；平台包只装二进制，升级它们就是换内核。
+
+## 发布前自检
+
+`cargo test --workspace`、`npm test --workspaces`，以及 `prepare --require-all` 门槛。

package/bin/omnicrawl.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// OmniCrawl 启动器：按 platform/arch 选出内核二进制并转交 stdio。
+//
+// 它不做任何协议转换——宿主直接与内核进程对话，启动器只是平台分包的解析器。
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import process from 'node:process'
+
+const PLATFORM_PACKAGES = {
+  'linux-x64': '@omnicrawl/cli-linux-x64',
+  'linux-arm64': '@omnicrawl/cli-linux-arm64-musl',
+  'win32-x64': '@omnicrawl/cli-win32-x64',
+  'win32-ia32': '@omnicrawl/cli-win32-ia32',
+}
+
+function resolveBinary() {
+  // 开发与测试用的逃生口：跳过分包直接指定二进制。
+  if (process.env.OMNICRAWL_BINARY) return process.env.OMNICRAWL_BINARY
+
+  const key = `${process.platform}-${process.arch}`
+  const packageName = PLATFORM_PACKAGES[key]
+  if (!packageName) {
+    throw new Error(`不支持的平台 ${key}；已支持：${Object.keys(PLATFORM_PACKAGES).join('、')}`)
+  }
+
+  const require = createRequire(import.meta.url)
+  const packageRoot = dirname(require.resolve(`${packageName}/package.json`))
+  const binary = join(packageRoot, 'bin', process.platform === 'win32' ? 'omnicrawl.exe' : 'omnicrawl')
+  if (!existsSync(binary)) {
+    throw new Error(`平台分包 ${packageName} 里没有二进制：${binary}\n请重装该包，或用 OMNICRAWL_BINARY 指定。`)
+  }
+  return binary
+}
+
+let binary
+try {
+  binary = resolveBinary()
+} catch (error) {
+  console.error(`omnicrawl：${error.message}`)
+  process.exit(1)
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' })
+
+child.on('error', (error) => {
+  console.error(`omnicrawl：无法启动 ${binary}：${error.message}`)
+  process.exit(1)
+})
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    console.error(`omnicrawl：内核被信号 ${signal} 终止`)
+    process.exit(1)
+  }
+  process.exit(code ?? 0)
+})

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "omnicrawl-cli",
+  "version": "0.1.68",
+  "description": "OmniCrawl 启动器：按平台选择内核二进制并转交 stdio",
+  "type": "module",
+  "bin": {
+    "omnicrawl": "bin/omnicrawl.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test",
+    "prepare:binaries": "node scripts/prepare.mjs"
+  },
+  "license": "MIT",
+  "optionalDependencies": {
+    "@omnicrawl/cli-win32-x64": "0.1.68",
+    "@omnicrawl/cli-win32-ia32": "0.1.68",
+    "@omnicrawl/cli-linux-x64": "0.1.68",
+    "@omnicrawl/cli-linux-arm64-musl": "0.1.68"
+  }
+}