@one-agent-ctx/native-runtime 0.1.0 → 0.1.4

package/README.md

@@ -124,7 +124,7 @@ Current tests and remaining migration gaps are recorded in
 Cross-compilation must not be described as native Windows execution.
 
 For the Node package, the [npm native qualification and release runbook](docs/refactor/06-platform-and-path-portability.md#npm-原生包资格)
-defines the four macOS/Windows targets, native and cross-compiled qualification,
+defines the six macOS/Linux/Windows targets, NAPI and CLI native qualification,
 runtime receipts, and explicit release prerequisites.
 
 See `docs/refactor/README.md` for the design source of truth and

package/cli.d.ts

@@ -0,0 +1,2 @@
+/** Absolute path to the verified CLI in the installed platform package. */
+export function cliPath(): string;

package/cli.js

@@ -0,0 +1,26 @@
+'use strict';
+const { resolvePlatform } = require('./platform.js');
+const { createHash } = require('node:crypto');
+const { readFileSync } = require('node:fs');
+
+/** Resolve the CLI distributed with the exact native platform package. */
+function cliPath() {
+  const platform = resolvePlatform(process.platform, process.arch,
+    process.platform === 'linux' ? process.report.getReport().header.glibcVersionRuntime : undefined);
+  const packageName = `@one-agent-ctx/runtime-${platform.id}`;
+  try {
+    const binary = require.resolve(`${packageName}/${platform.cli}`);
+    const receipt = require(`${packageName}/artifact.json`);
+    const version = require('./package.json').version;
+    const digest = createHash('sha256').update(readFileSync(binary)).digest('hex');
+    if (receipt.version !== version || receipt.platform !== platform.id || receipt.cliSha256 !== digest) {
+      throw new Error(`${packageName} CLI bytes differ from its published artifact identity`);
+    }
+    return binary;
+  } catch (cause) {
+    if (cause.code !== 'MODULE_NOT_FOUND') throw cause;
+    throw new Error(`${packageName} CLI is not installed. Install @one-agent-ctx/native-runtime with optional dependencies enabled.`, { cause });
+  }
+}
+
+module.exports = { cliPath };

package/package.json

@@ -1,19 +1,23 @@
 {
   "name": "@one-agent-ctx/native-runtime",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "description": "Agent Context OS - native Node.js binding (napi-rs). Memories, skills, resources, self-evolution.",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
     "index.js",
     "index.d.ts",
-    "platform.js"
+    "platform.js",
+    "cli.js",
+    "cli.d.ts"
   ],
   "optionalDependencies": {
-    "@one-agent-ctx/runtime-darwin-arm64": "0.1.0",
-    "@one-agent-ctx/runtime-darwin-x64": "0.1.0",
-    "@one-agent-ctx/runtime-win32-x64-msvc": "0.1.0",
-    "@one-agent-ctx/runtime-win32-arm64-msvc": "0.1.0"
+    "@one-agent-ctx/runtime-darwin-arm64": "0.1.4",
+    "@one-agent-ctx/runtime-darwin-x64": "0.1.4",
+    "@one-agent-ctx/runtime-linux-arm64": "0.1.4",
+    "@one-agent-ctx/runtime-linux-x64": "0.1.4",
+    "@one-agent-ctx/runtime-win32-x64-msvc": "0.1.4",
+    "@one-agent-ctx/runtime-win32-arm64-msvc": "0.1.4"
   },
   "scripts": {
     "test:npm": "node --test tests/harness/npm-release.test.mjs",

package/platform.js

@@ -2,10 +2,12 @@
 
 // One distribution roster drives package resolution and release qualification.
 const platforms = Object.freeze([
-  { id: 'darwin-arm64', os: 'darwin', cpu: 'arm64', target: 'aarch64-apple-darwin', runner: 'macos-15', library: 'libctxos_napi.dylib' },
-  { id: 'darwin-x64', os: 'darwin', cpu: 'x64', target: 'x86_64-apple-darwin', runner: 'macos-15-intel', library: 'libctxos_napi.dylib' },
-  { id: 'win32-arm64-msvc', os: 'win32', cpu: 'arm64', target: 'aarch64-pc-windows-msvc', runner: 'windows-11-arm', library: 'ctxos_napi.dll' },
-  { id: 'win32-x64-msvc', os: 'win32', cpu: 'x64', target: 'x86_64-pc-windows-msvc', runner: 'windows-2025', library: 'ctxos_napi.dll' },
+  { id: 'darwin-arm64', os: 'darwin', cpu: 'arm64', target: 'aarch64-apple-darwin', runner: 'macos-15', library: 'libctxos_napi.dylib', cli: 'ctxos' },
+  { id: 'darwin-x64', os: 'darwin', cpu: 'x64', target: 'x86_64-apple-darwin', runner: 'macos-15-intel', library: 'libctxos_napi.dylib', cli: 'ctxos' },
+  { id: 'linux-arm64', os: 'linux', cpu: 'arm64', target: 'aarch64-unknown-linux-gnu', runner: 'ubuntu-24.04-arm', library: 'libctxos_napi.so', cli: 'ctxos' },
+  { id: 'linux-x64', os: 'linux', cpu: 'x64', target: 'x86_64-unknown-linux-gnu', runner: 'ubuntu-24.04', library: 'libctxos_napi.so', cli: 'ctxos' },
+  { id: 'win32-arm64-msvc', os: 'win32', cpu: 'arm64', target: 'aarch64-pc-windows-msvc', runner: 'windows-11-arm', library: 'ctxos_napi.dll', cli: 'ctxos.exe' },
+  { id: 'win32-x64-msvc', os: 'win32', cpu: 'x64', target: 'x86_64-pc-windows-msvc', runner: 'windows-2025', library: 'ctxos_napi.dll', cli: 'ctxos.exe' },
 ].map(Object.freeze));
 
 function resolvePlatform(os, cpu, glibcVersion) {