@skaft/octet 0.0.0 → 0.8.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Achuthan Mukundan and Skaft Software contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,22 @@
-# @skaft/octet
+# octet npm launcher
 
-This `0.0.0` version only reserves the package name. It contains no Octet executable or runtime and is not an installation channel. Use the [official installation instructions](https://github.com/skaft-software/octet#installation) until a verified npm release is announced.
+`@skaft/octet` is a small, shell-only launcher for the native octet
+runtime. npm selects one exact-version platform package through
+`optionalDependencies`; the normal `octet` and `octet-host` paths immediately `exec`
+the selected native binary.
+
+These scoped names are source packaging identities, not proof of registry rights
+or availability. Use the installation command only after an authorized release
+has published the packages.
+
+The launcher does not run Node, access the network, download an archive, or
+execute an install lifecycle hook. Install it with scripts, audit, and funding
+requests disabled:
+
+```sh
+npm install --global --ignore-scripts --no-audit --no-fund @skaft/octet@0.8.1
+```
+
+GNU/Linux uses the glibc x64 package. macOS uses the arm64 or x64 package that
+matches the running executable. `octet doctor` reports a missing `rg`
+prerequisite.

package/bin/octet

@@ -0,0 +1,26 @@
+#!/bin/sh
+set -eu
+
+# npm may expose bin/octet through a symlink in its global bin directory. Resolve
+# that link without changing the caller's cwd before handing off to the common
+# shell-only launcher.
+script=$0
+case "$script" in
+    /*) ;;
+    *) script=$(pwd -P)/$script ;;
+esac
+while [ -L "$script" ]; do
+    link=$(readlink "$script") || {
+        printf '%s\n' 'octet npm launcher could not resolve its executable path' >&2
+        exit 1
+    }
+    case "$link" in
+        /*) script=$link ;;
+        *) script=$(dirname "$script")/$link ;;
+    esac
+done
+script_directory=$(CDPATH= cd -P -- "$(dirname "$script")" 2>/dev/null && pwd -P) || {
+    printf '%s\n' 'octet npm launcher could not resolve its package directory' >&2
+    exit 1
+}
+exec "$script_directory/../lib/launch.sh" octet "$@"

package/bin/octet-host

@@ -0,0 +1,25 @@
+#!/bin/sh
+set -eu
+
+# npm may expose bin/octet-host through a symlink in its global bin directory.
+# Resolve it before exec so package lookup remains independent of PATH.
+script=$0
+case "$script" in
+    /*) ;;
+    *) script=$(pwd -P)/$script ;;
+esac
+while [ -L "$script" ]; do
+    link=$(readlink "$script") || {
+        printf '%s\n' 'octet npm launcher could not resolve its executable path' >&2
+        exit 1
+    }
+    case "$link" in
+        /*) script=$link ;;
+        *) script=$(dirname "$script")/$link ;;
+    esac
+done
+script_directory=$(CDPATH= cd -P -- "$(dirname "$script")" 2>/dev/null && pwd -P) || {
+    printf '%s\n' 'octet npm launcher could not resolve its package directory' >&2
+    exit 1
+}
+exec "$script_directory/../lib/launch.sh" octet-host "$@"

package/lib/launch.sh

@@ -0,0 +1,117 @@
+#!/bin/sh
+set -eu
+
+package_version="0.8.1"
+
+fail() {
+    printf '%s\n' "$1" >&2
+    exit 1
+}
+
+command_name=${1-}
+case "$command_name" in
+    octet|octet-host) ;;
+    *) fail 'octet npm launcher received an invalid native command' ;;
+esac
+shift
+
+# npm exposes each bin entry through a symlink in its global bin directory.
+# Resolve it without changing the caller's working directory before locating
+# the package-local launcher.
+script=$0
+case "$script" in
+    /*) ;;
+    *) script=$(pwd -P)/$script ;;
+esac
+while [ -L "$script" ]; do
+    link=$(readlink "$script") || fail 'octet npm launcher could not resolve its executable path'
+    case "$link" in
+        /*) script=$link ;;
+        *) script=$(dirname "$script")/$link ;;
+    esac
+done
+launch_directory=$(CDPATH= cd -P -- "$(dirname "$script")" 2>/dev/null && pwd -P) || \
+    fail 'octet npm launcher could not resolve its package directory'
+launcher_root=$(CDPATH= cd -P -- "$launch_directory/.." 2>/dev/null && pwd -P) || \
+    fail 'octet npm launcher could not resolve its package root'
+[ -d "$launcher_root" ] && [ ! -L "$launcher_root" ] || \
+    fail 'octet npm launcher package root is not a real directory'
+
+operating_system=$(uname -s 2>/dev/null) || fail 'octet npm launcher requires uname'
+machine=$(uname -m 2>/dev/null) || fail 'octet npm launcher could not determine the CPU architecture'
+platform_package=
+case "$operating_system:$machine" in
+    Darwin:arm64|Darwin:aarch64)
+        platform_package='@skaft/octet-darwin-arm64'
+        ;;
+    Darwin:x86_64|Darwin:amd64)
+        # Select the package matching the executable ABI. An x86_64 octet under
+        # Rosetta is still an x86_64 binary and must not exec arm64 code.
+        platform_package='@skaft/octet-darwin-x64'
+        ;;
+    Linux:x86_64|Linux:amd64)
+        glibc_available=false
+        if command -v getconf >/dev/null 2>&1; then
+            glibc_version=$(getconf GNU_LIBC_VERSION 2>/dev/null || true)
+            case "$glibc_version" in
+                glibc\ *|GNU\ libc\ *) glibc_available=true ;;
+            esac
+        fi
+        if [ "$glibc_available" != true ] && command -v ldd >/dev/null 2>&1; then
+            ldd_version=$(ldd --version 2>&1 || true)
+            case "$ldd_version" in
+                *glibc*|*GLIBC*|*'GNU libc'*|*'GNU C Library'*) glibc_available=true ;;
+            esac
+        fi
+        [ "$glibc_available" = true ] || \
+            fail 'octet npm package requires GNU libc on Linux; musl is not supported'
+        platform_package='@skaft/octet-linux-x64-gnu'
+        ;;
+    Darwin:*) fail "octet npm package does not support macOS architecture: $machine" ;;
+    Linux:*) fail "octet npm package does not support Linux architecture: $machine" ;;
+    *) fail "octet npm package does not support operating system: $operating_system" ;;
+esac
+
+platform_name=${platform_package#*/}
+platform_root=
+# npm may nest optional dependencies below the public package or hoist them to
+# the sibling scope directory. Both layouts are explicit; there is no network
+# resolver or fallback package.
+for candidate in \
+    "$launcher_root/node_modules/$platform_package" \
+    "$launcher_root/../$platform_name"; do
+    if [ -d "$candidate" ] && [ ! -L "$candidate" ]; then
+        platform_root=$candidate
+        break
+    fi
+done
+[ -n "$platform_root" ] || \
+    fail "octet npm package is missing the selected platform runtime: $platform_package"
+
+for required in \
+    "$platform_root/package.json" \
+    "$platform_root/README.md" \
+    "$platform_root/LICENSE" \
+    "$platform_root/bin/$command_name" \
+    "$platform_root/share/octet/.octet-version" \
+    "$platform_root/share/octet/README.md"; do
+    [ -f "$required" ] && [ ! -L "$required" ] || \
+        fail "octet npm platform package is incomplete: $platform_root"
+done
+for required_directory in \
+    "$platform_root/bin" \
+    "$platform_root/share/octet" \
+    "$platform_root/share/octet/docs" \
+    "$platform_root/share/octet/examples" \
+    "$platform_root/share/octet/sdk"; do
+    [ -d "$required_directory" ] && [ ! -L "$required_directory" ] || \
+        fail "octet npm platform package is incomplete: $platform_root"
+done
+[ -x "$platform_root/bin/$command_name" ] || \
+    fail "octet npm platform executable is not executable: $platform_root/bin/$command_name"
+[ "$(cat "$platform_root/share/octet/.octet-version")" = "$package_version" ] || \
+    fail "octet npm platform version does not match launcher version $package_version"
+
+# Do not print on the successful path: octet-host stdout is a protocol stream.
+# exec preserves cwd, argv, environment, stdio, signal delivery, and status.
+exec "$platform_root/bin/$command_name" "$@"

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@skaft/octet",
-  "version": "0.0.0",
-  "description": "Reserved package name for the Octet npm distribution; no runtime is included.",
+  "version": "0.8.1",
+  "description": "Native octet coding agent launcher",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/skaft-software/octet.git"
-  },
-  "publishConfig": {
-    "access": "public",
-    "tag": "reserved",
-    "registry": "https://registry.npmjs.org/"
-  },
+  "repository": "https://github.com/skaft-software/octet",
   "files": [
-    "README.md"
-  ]
+    "README.md",
+    "LICENSE",
+    "bin/",
+    "lib/"
+  ],
+  "bin": {
+    "octet": "bin/octet",
+    "octet-host": "bin/octet-host"
+  },
+  "optionalDependencies": {
+    "@skaft/octet-darwin-arm64": "0.8.1",
+    "@skaft/octet-darwin-x64": "0.8.1",
+    "@skaft/octet-linux-x64-gnu": "0.8.1"
+  }
 }