@paniolo/cli 0.5.0

package/README.md

@@ -0,0 +1,19 @@
+# @paniolo/cli
+
+Internal distribution of the unified native `paniolo` CLI.
+
+The wrapper selects one optional per-platform package and launches its bundled
+binary. Commands include `paniolo scan`, `paniolo qmd`, `paniolo wiki`,
+`paniolo evolve`, and `paniolo mcp`.
+
+## Local release workflow
+
+```bash
+node npm/scripts/gen-packages.mjs --tool cli
+node npm/scripts/stage-binaries.mjs --tool cli
+node npm/scripts/pack-smoke.mjs --tool cli
+```
+
+Ranch Hand releases are validated locally. `paniolo-internal` is not included
+in this package family; harness maintenance scripts invoke it from the sibling
+Ranch Hand source checkout.

package/bin/paniolo.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+
+// Thin launcher for the native paniolo CLI. The binary itself ships in a
+// per-platform optional dependency (@paniolo/cli-<platform>-<arch>); npm only
+// installs the one matching the host's os/cpu. We resolve that package here and
+// exec its binary. No network access, no postinstall — see
+// docs/cross-building.md for how the binaries are produced and published.
+
+const fs = require("fs");
+const path = require("path");
+const { spawn } = require("child_process");
+
+// npm tarballs packed on Windows lose the Unix executable bit, so a binary
+// published from a Windows machine arrives mode 0644 and fails to spawn with
+// EACCES on Linux/macOS. Restore the bit at runtime (only when missing, and
+// best-effort so a read-only install still surfaces the real spawn error).
+function ensureExecutable(binary) {
+  if (process.platform === "win32") {
+    return;
+  }
+  try {
+    const { mode } = fs.statSync(binary);
+    if ((mode & 0o111) === 0) {
+      fs.chmodSync(binary, 0o755);
+    }
+  } catch {
+    // ignore; the spawn below will report a meaningful error if truly broken
+  }
+}
+
+// The supported platform/arch keys, the platform-package scope, and the binary
+// name are derived from this wrapper's own package.json — its
+// optionalDependencies are the per-platform packages, generated from the single
+// target list in npm/scripts/tools.mjs. So nothing about the target set is
+// duplicated here; adding a platform there flows through on the next generate.
+const wrapperPkg = require("../package.json");
+const PKG_PREFIX = `${wrapperPkg.name}-`; // e.g. "@paniolo/cli-"
+const BIN_NAME = Object.keys(wrapperPkg.bin)[0]; // "paniolo"
+const SUPPORTED = new Set(
+  Object.keys(wrapperPkg.optionalDependencies || {}).map((dep) => dep.slice(PKG_PREFIX.length))
+);
+
+function resolveBinary() {
+  const key = `${process.platform}-${process.arch}`;
+  if (!SUPPORTED.has(key)) {
+    return { error: `unsupported platform/arch: ${key}` };
+  }
+
+  const pkg = `${PKG_PREFIX}${key}`;
+  const exe = process.platform === "win32" ? `${BIN_NAME}.exe` : BIN_NAME;
+  try {
+    // Resolve via the platform package's manifest so this works regardless of
+    // how the binary file is named in `exports`.
+    const manifest = require.resolve(`${pkg}/package.json`);
+    return { binary: path.join(path.dirname(manifest), exe) };
+  } catch {
+    return {
+      error:
+        `the platform package ${pkg} is not installed.\n` +
+        `Reinstall ${wrapperPkg.name} with optional dependencies enabled ` +
+        `(npm install --include=optional, or remove --no-optional / --omit=optional).`,
+    };
+  }
+}
+
+const resolved = resolveBinary();
+if (resolved.error) {
+  process.stderr.write(`${BIN_NAME}: ${resolved.error}\n`);
+  process.exit(1);
+}
+
+ensureExecutable(resolved.binary);
+
+const child = spawn(resolved.binary, process.argv.slice(2), { stdio: "inherit" });
+child.on("error", (error) => {
+  process.stderr.write(`${BIN_NAME}: failed to run ${resolved.binary}: ${error.message}\n`);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal !== null) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 0);
+});

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@paniolo/cli",
+  "version": "0.5.0",
+  "description": "Unified native Paniolo CLI, distributed as per-platform npm packages.",
+  "license": "UNLICENSED",
+  "bin": {
+    "paniolo": "bin/paniolo.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@paniolo/cli-linux-x64": "0.5.0",
+    "@paniolo/cli-linux-arm64": "0.5.0",
+    "@paniolo/cli-win32-x64": "0.5.0",
+    "@paniolo/cli-win32-arm64": "0.5.0",
+    "@paniolo/cli-darwin-x64": "0.5.0",
+    "@paniolo/cli-darwin-arm64": "0.5.0"
+  }
+}