@rtorr/nah 1.0.7 → 1.0.12

package/README.md

@@ -0,0 +1,112 @@
+# NAH - Native Application Host
+
+[![CI](https://github.com/rtorr/nah/actions/workflows/ci.yml/badge.svg)](https://github.com/rtorr/nah/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-API-blue)](https://nah.rtorr.com/)
+
+NAH is a launch contract system for native applications.
+
+When you deploy a native application, someone must figure out how to launch it: which binary, what library paths, which environment variables, what SDK version. This information typically lives in documentation that drifts, install scripts that diverge, or tribal knowledge that doesn't scale.
+
+NAH eliminates this by making applications self-describing. Apps declare what they need. SDKs declare what they provide. Hosts declare policy. NAH composes these into a launch contract - the exact parameters needed to run the application.
+
+## What NAH Provides
+
+**For host operators**: Install an app, query its launch contract. No need to read documentation or reverse-engineer scripts. The contract tells you the binary path, library paths, environment variables, and working directory.
+
+**For app developers**: Embed a manifest declaring your SDK requirement and entrypoint. Ship one package that works on any host with a compatible SDK, regardless of where the SDK is installed.
+
+**For SDK developers**: Package your libraries once. Multiple versions coexist on the same host. Apps pin to compatible versions at install time. Update the SDK without breaking existing apps.
+
+## Example
+
+```bash
+# Install from local files
+nah --root /opt/nah nak install vendor-sdk-2.1.0.nak
+nah --root /opt/nah app install myapp-1.0.0.nap
+
+# Or install directly from URLs
+nah --root /opt/nah nak install https://example.com/vendor-sdk-2.1.0.nak
+nah --root /opt/nah app install https://example.com/myapp-1.0.0.nap
+
+# Query the launch contract
+nah --root /opt/nah contract show com.example.myapp
+```
+
+```
+Application: com.example.myapp v1.0.0
+SDK: com.vendor.sdk v2.1.0
+Binary: /opt/nah/apps/com.example.myapp-1.0.0/bin/myapp
+CWD: /opt/nah/apps/com.example.myapp-1.0.0
+Library Paths: /opt/nah/naks/com.vendor.sdk/2.1.0/lib
+Environment:
+  NAH_APP_ID=com.example.myapp
+  NAH_APP_VERSION=1.0.0
+  NAH_NAK_ROOT=/opt/nah/naks/com.vendor.sdk/2.1.0
+```
+
+The contract is deterministic. Same inputs, same output. Auditable before execution.
+
+## Key Properties
+
+- **No network at launch time**: Contract composition uses only local state
+- **No dependency solving**: Apps declare requirements, hosts install SDKs, NAH matches them
+- **Version coexistence**: Multiple SDK versions installed side-by-side
+- **Install-time pinning**: SDK version locked when app is installed, not resolved at launch
+- **Host controls layout**: SDKs and apps go where the host decides, not where the app expects
+
+## When to Use NAH
+
+NAH is designed for environments where:
+
+- Apps and SDKs come from different vendors or teams
+- Hosts need to control where software is installed
+- Multiple SDK versions must coexist for different apps
+- Launch configuration must be auditable
+- Apps must remain portable across different host configurations
+
+## Installation
+
+```bash
+# npm (recommended)
+npm install -g @rtorr/nah
+
+# Linux (manual)
+curl -L https://github.com/rtorr/nah/releases/latest/download/nah-linux-x64.tar.gz | tar xz
+sudo mv nah /usr/local/bin/
+
+# macOS (manual)
+curl -L https://github.com/rtorr/nah/releases/latest/download/nah-macos-arm64.tar.gz | tar xz
+sudo mv nah /usr/local/bin/
+
+# From source
+git clone https://github.com/rtorr/nah.git && cd nah
+cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build
+sudo cmake --install build
+```
+
+## Library Integration
+
+NAH can be embedded as a C++ library:
+
+```cmake
+include(FetchContent)
+FetchContent_Declare(nah GIT_REPOSITORY https://github.com/rtorr/nah.git GIT_TAG v1.0.0)
+FetchContent_MakeAvailable(nah)
+target_link_libraries(your_target PRIVATE nahhost)
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Concepts](docs/concepts.md) | Core terminology: manifests, NAKs, profiles, contracts |
+| [Getting Started: Host](docs/getting-started-host.md) | Set up a host and deploy applications |
+| [Getting Started: SDK](docs/getting-started-nak.md) | Package an SDK for distribution |
+| [Getting Started: App](docs/getting-started-app.md) | Build an application with a manifest |
+| [CLI Reference](docs/cli.md) | Command-line interface documentation |
+| [Specification](SPEC.md) | Normative specification |
+| [Contributing](CONTRIBUTING.md) | Development setup and releasing |
+
+## License
+
+MIT

package/{bin → npm-bin}/nah

@@ -9,7 +9,7 @@ const binaryPath = path.join(__dirname, binaryName);
 
 if (!fs.existsSync(binaryPath)) {
   console.error("nah binary not found. Try reinstalling the package:");
-  console.error("  npm uninstall -g nah-cli && npm install -g nah-cli");
+  console.error("  npm uninstall -g @rtorr/nah && npm install -g @rtorr/nah");
   process.exit(1);
 }
 

package/{scripts → npm-scripts}/install.js

@@ -41,13 +41,19 @@ function downloadFile(url) {
 
       https
         .get(url, (response) => {
-          if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+          if (
+            response.statusCode >= 300 &&
+            response.statusCode < 400 &&
+            response.headers.location
+          ) {
             follow(response.headers.location, redirects + 1);
             return;
           }
 
           if (response.statusCode !== 200) {
-            reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+            reject(
+              new Error(`Failed to download: HTTP ${response.statusCode}`),
+            );
             return;
           }
 
@@ -95,8 +101,16 @@ function extractTar(tarData, destDir) {
     }
 
     // Parse header
-    const name = header.slice(0, 100).toString("utf8").replace(/\0/g, "").trim();
-    const sizeOctal = header.slice(124, 136).toString("utf8").replace(/\0/g, "").trim();
+    const name = header
+      .slice(0, 100)
+      .toString("utf8")
+      .replace(/\0/g, "")
+      .trim();
+    const sizeOctal = header
+      .slice(124, 136)
+      .toString("utf8")
+      .replace(/\0/g, "")
+      .trim();
     const size = parseInt(sizeOctal, 8) || 0;
     const typeFlag = header[156];
 
@@ -130,11 +144,13 @@ async function main() {
 
   if (!supportedPlatform) {
     console.error(`Unsupported platform: ${platformKey}`);
-    console.error(`Supported platforms: ${Object.keys(PLATFORM_MAP).join(", ")}`);
+    console.error(
+      `Supported platforms: ${Object.keys(PLATFORM_MAP).join(", ")}`,
+    );
     process.exit(1);
   }
 
-  const binDir = path.join(__dirname, "..", "bin");
+  const binDir = path.join(__dirname, "..", "npm-bin");
   const binaryPath = path.join(binDir, getBinaryName());
 
   // Check if binary already exists

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtorr/nah",
-  "version": "1.0.7",
+  "version": "1.0.12",
   "description": "Native Application Host - Manage native applications, NAKs, profiles, and launch contracts",
   "keywords": [
     "native",
@@ -22,17 +22,17 @@
   },
   "homepage": "https://github.com/rtorr/nah#readme",
   "bin": {
-    "nah": "bin/nah"
+    "nah": "npm-bin/nah"
   },
   "scripts": {
-    "postinstall": "node scripts/install.js"
+    "postinstall": "node npm-scripts/install.js"
   },
   "engines": {
     "node": ">=14"
   },
   "files": [
-    "bin",
-    "scripts"
+    "npm-bin",
+    "npm-scripts"
   ],
   "os": [
     "darwin",