@openagentsinc/pylon 0.1.1 → 0.1.3

package/README.md

@@ -1,33 +1,57 @@
 # `@openagentsinc/pylon`
 
 Bootstrap the latest tagged standalone `Pylon` release asset from GitHub
-Releases, stream first-run status updates in the terminal, and open the Pylon
-terminal UI without Cargo.
+Releases, fall back to a deterministic source build when no matching asset
+exists for the local platform, stream first-run status updates in the terminal,
+and open the Pylon terminal UI without Cargo when prebuilt binaries are
+available.
 
 ## Usage
 
 ```bash
 npx @openagentsinc/pylon
-npx @openagentsinc/pylon --version 0.0.1-rc3
+bunx @openagentsinc/pylon
+npm install -g @openagentsinc/pylon && pylon
+bun install -g @openagentsinc/pylon && pylon
+npx @openagentsinc/pylon --version 0.0.1-rc4
 npx @openagentsinc/pylon --no-launch
-npx @openagentsinc/pylon --model gemma-4-e2b --diagnostic-repeats 2
+npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --diagnostic-repeats 2
+npx @openagentsinc/pylon --verbose
 ```
 
 The launcher:
 
-- resolves the latest tagged `pylon-v...` release by default, or a specific
-  tagged `Pylon` version when `--version` is provided
+- supports direct `npx` / `bunx` execution plus global `npm install -g` /
+  `bun install -g` installs with the same `pylon` command
+- checks GitHub for the latest tagged `pylon-v...` release on each default run,
+  or resolves a specific tagged `Pylon` version when `--version` is provided
 - resolves the correct `pylon-v<version>-<os>-<arch>.tar.gz` asset for the
   current machine
+- falls back to the exact tagged source checkout and builds `pylon` plus
+  `pylon-tui` locally when no matching release asset exists for the machine
+- prompts before installing the Rust toolchain via `rustup` if a source build
+  is needed and `cargo` / `rustc` are missing
 - downloads the archive and published SHA-256 checksum
 - verifies the checksum before extracting
 - caches the unpacked binaries under `~/.openagents/pylon/bootstrap/`
+- never links or copies those cached standalone binaries into a shared global
+  bin directory, so the package-managed `pylon` launcher remains the command on
+  `PATH`
 - prints status lines such as release resolution, runtime checks, and local
   model scanning while it runs
+- ends first run with an explicit verdict such as `fully online`, `runtime
+  ready`, or `installed but runtime missing`, plus exact next-step guidance
 - runs `pylon --help`, `init`, `status --json`, and `inventory --json`
-- runs `pylon gemma download <model>`
 - runs `pylon gemma diagnose <model> --json`
+- only runs `pylon gemma download <model>` when `--download-curated-cache` is
+  set, because the optional GGUF cache does not satisfy the sellable runtime by
+  itself
+- falls back to `curl` for release metadata and asset downloads when the Node
+  fetch path fails in constrained network contexts
 - opens `pylon-tui` by default after the smoke path unless `--no-launch` is set
+- does not try to install or register a local runtime automatically; the
+  bootstrap stays honest about the separate Ollama-compatible runtime
+  prerequisite instead of mutating the host behind the user's back
 
 ## Publish
 
@@ -35,5 +59,6 @@ Publish directly from this package directory:
 
 ```bash
 cd packages/pylon-bootstrap
+npm pack --dry-run
 npm publish
 ```

package/bin/pylon

@@ -0,0 +1,26 @@
+#!/bin/sh
+
+set -eu
+
+SCRIPT_PATH="$0"
+while [ -L "$SCRIPT_PATH" ]; do
+  LINK_TARGET=$(readlink "$SCRIPT_PATH")
+  case "$LINK_TARGET" in
+    /*) SCRIPT_PATH="$LINK_TARGET" ;;
+    *) SCRIPT_PATH="$(dirname -- "$SCRIPT_PATH")/$LINK_TARGET" ;;
+  esac
+done
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$SCRIPT_PATH")" && pwd)
+LAUNCHER_JS="${SCRIPT_DIR}/pylon.js"
+
+if command -v node >/dev/null 2>&1; then
+  exec node "$LAUNCHER_JS" "$@"
+fi
+
+if command -v bun >/dev/null 2>&1; then
+  exec bun "$LAUNCHER_JS" "$@"
+fi
+
+echo "pylon launcher requires Node.js or Bun on PATH." >&2
+exit 1

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {
-    "pylon": "./bin/pylon.js"
+    "pylon": "./bin/pylon"
   },
   "files": [
     "bin",

package/src/cli.js

@@ -7,6 +7,7 @@ import {
   bootstrapInstalledPylon,
   ensureReleaseInstall,
   launchInstalledPylonTui,
+  resolveBootstrapOutcome,
   renderBootstrapSummary,
 } from "./index.js";
 
@@ -67,27 +68,38 @@ function createReporter({ enableColor = process.stdout.isTTY && !process.env.NO_
 export function usage() {
   return `Usage:
   npx @openagentsinc/pylon [options]
+  bunx @openagentsinc/pylon [options]
+  pylon [options]
 
 Description:
   Download the latest tagged standalone Pylon release asset for this machine,
-  or a specific tagged Pylon version when --version is set. Verify its
-  checksum, cache the binaries locally, run the first-run smoke path, and then
-  open the Pylon terminal UI by default with live status updates.
+  or a specific tagged Pylon version when --version is set. If no matching
+  asset exists for the local platform, fetch the exact tagged source checkout
+  and build it locally instead. Cache the binaries, run the first-run smoke
+  path, and then open the Pylon terminal UI by default with live status
+  updates. The launcher checks GitHub for newer tagged pylon-v... releases on
+  each default run, but only caches the standalone binaries under the local
+  bootstrap root; it does not replace your global npm or bun pylon command.
 
 Options:
   --version <x.y.z>                    Resolve a specific Pylon release.
   --install-root <path>                Override the launcher cache/install root.
   --config-path <path>                 Override OPENAGENTS_PYLON_CONFIG_PATH.
   --pylon-home <path>                  Override OPENAGENTS_PYLON_HOME.
-  --model <model-id>                   Model to download and diagnose.
+  --model <model-id>                   Model to diagnose, and optionally
+                                       prefetch into the local GGUF cache.
                                        Default: ${DEFAULT_MODEL_ID}
+  --download-curated-cache             Prefetch the optional Hugging Face GGUF
+                                       cache before opening the TUI.
   --diagnostic-repeats <n>             Repeat count for pylon gemma diagnose.
                                        Default: ${DEFAULT_DIAGNOSTIC_REPEATS}
   --diagnostic-max-output-tokens <n>   Max output tokens for diagnostics.
                                        Default: ${DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS}
-  --skip-model-download                Skip pylon gemma download.
+  --skip-model-download                Keep the curated GGUF cache skipped.
   --skip-diagnostics                   Skip pylon gemma diagnose.
   --no-launch                          Do not open pylon-tui after bootstrap.
+  --verbose                            Print extra network and recovery detail.
+  --debug-network                      Alias for --verbose.
   --json                               Emit a machine-readable JSON summary.
 
 Test and maintainer options:
@@ -108,9 +120,10 @@ export function parseArgs(argv) {
     model: DEFAULT_MODEL_ID,
     diagnosticRepeats: DEFAULT_DIAGNOSTIC_REPEATS,
     diagnosticMaxOutputTokens: DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS,
-    skipModelDownload: false,
+    skipModelDownload: true,
     skipDiagnostics: false,
     noLaunch: false,
+    verbose: false,
     json: false,
     help: false,
   };
@@ -148,6 +161,9 @@ export function parseArgs(argv) {
           throw new Error("--model requires a value.");
         }
         break;
+      case "--download-curated-cache":
+        options.skipModelDownload = false;
+        break;
       case "--diagnostic-repeats":
         options.diagnosticRepeats = parseIntegerFlag(
           argv[++index],
@@ -169,6 +185,10 @@ export function parseArgs(argv) {
       case "--no-launch":
         options.noLaunch = true;
         break;
+      case "--verbose":
+      case "--debug-network":
+        options.verbose = true;
+        break;
       case "--json":
         options.json = true;
         break;
@@ -229,7 +249,12 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
   if (options.json) {
     console.log(JSON.stringify(summary, null, 2));
   } else {
-    reporter?.success("Pylon bootstrap complete");
+    const outcome = resolveBootstrapOutcome(summary);
+    if (outcome.level === "success") {
+      reporter?.success(`Pylon ${outcome.verdict}`, outcome.detail);
+    } else {
+      reporter?.warning(`Pylon ${outcome.verdict}`, outcome.detail);
+    }
     console.log(renderBootstrapSummary(summary));
     if (!options.noLaunch) {
       await launchInstalledPylonTuiImpl(