@nettoolskit/memory 0.0.1-preview.1 → 0.0.1-preview.2

package/README.md

@@ -788,4 +788,7 @@ ntk-memory --help
 npx @nettoolskit/memory --help
 ```
 
-The npm wrapper executes a native `ntk-memory` binary from `npm/native/` when release packaging stages one. For development or private release validation, set `NTK_MEMORY_BINARY` to an already built local binary. Use `npm run stage:native -- <path-to-binary>` before packaging a native tarball.
+The npm wrapper executes a native `ntk-memory` binary from `npm/native/` when release packaging stages one. For development or private release validation, set `NTK_MEMORY_BINARY` to an already built local binary. Use `npm run stage:native -- <path-to-binary>` before packaging a native tarball.
+## Package publication
+
+Current preview package: `@nettoolskit/memory@0.0.1-preview.2`. Use `npx @nettoolskit/memory` for ephemeral execution or `ntk-memory` after global installation. GitRiver stage `river/publish` runs package dry-run validation on pull requests and publishes only from `main` or `v*` source refs through `scripts/ci/river/npm-publish.sh`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nettoolskit/memory",
-  "version": "0.0.1-preview.1",
+  "version": "0.0.1-preview.2",
   "description": "Knowledge ingestion, local memory, RAG, HyDE, retrieval, context packages, and vault materialization for NetToolsKit.",
   "license": "MIT",
   "keywords": [
@@ -25,12 +25,17 @@
     "README.md",
     "npm/cli/ntk-memory.js",
     "npm/native/",
+    "scripts/npm/assert-native-bundled.js",
     "scripts/npm/postinstall.js",
     "scripts/npm/stage-native.js"
   ],
   "scripts": {
+    "build:native": "cargo build --release --bin ntk-memory",
+    "prepublishOnly": "node scripts/npm/assert-native-bundled.js",
     "postinstall": "node scripts/npm/postinstall.js",
     "stage:native": "node scripts/npm/stage-native.js",
+    "test:package-wrapper": "node scripts/npm/test-package-wrapper-smoke.js",
+    "test:package-tarball": "node scripts/npm/test-package-tarball-install-smoke.js",
     "pack:dry-run": "npm pack --ignore-scripts --dry-run"
   },
   "publishConfig": {

package/scripts/npm/assert-native-bundled.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const nativeName = process.platform === "win32" ? "ntk-memory.exe" : "ntk-memory";
+const nativePath = path.resolve(__dirname, "..", "..", "npm", "native", nativeName);
+
+if (!fs.existsSync(nativePath)) {
+  console.error(`Missing bundled ntk-memory native binary: ${nativePath}`);
+  console.error("Run `npm run build:native` and `npm run stage:native` before publishing.");
+  process.exit(1);
+}
+
+const stat = fs.statSync(nativePath);
+if (!stat.isFile() || stat.size === 0) {
+  console.error(`Invalid bundled ntk-memory native binary: ${nativePath}`);
+  process.exit(1);
+}
+
+console.log(`Bundled ntk-memory native binary is present: ${nativeName}`);

package/scripts/npm/stage-native.js

@@ -7,8 +7,17 @@ const path = require("node:path");
 const binaryName = process.platform === "win32" ? "ntk-memory.exe" : "ntk-memory";
 const repoRoot = path.resolve(__dirname, "..", "..");
 const explicitSource = process.argv[2] || process.env.NTK_MEMORY_STAGE_BINARY;
+const cargoTargetDir = process.env.CARGO_TARGET_DIR
+  ? path.resolve(process.env.CARGO_TARGET_DIR)
+  : null;
 const candidates = [
   explicitSource,
+  cargoTargetDir ? path.join(cargoTargetDir, "release", binaryName) : null,
+  cargoTargetDir ? path.join(cargoTargetDir, "x86_64-pc-windows-msvc", "release", "ntk-memory.exe") : null,
+  cargoTargetDir ? path.join(cargoTargetDir, "x86_64-unknown-linux-gnu", "release", "ntk-memory") : null,
+  path.join(repoRoot, ".build", "target", "release", binaryName),
+  path.join(repoRoot, ".build", "target", "x86_64-pc-windows-msvc", "release", "ntk-memory.exe"),
+  path.join(repoRoot, ".build", "target", "x86_64-unknown-linux-gnu", "release", "ntk-memory"),
   path.join(repoRoot, "target", "release", binaryName),
   path.join(repoRoot, "target", "x86_64-pc-windows-msvc", "release", "ntk-memory.exe"),
   path.join(repoRoot, "target", "x86_64-unknown-linux-gnu", "release", "ntk-memory"),