@openagentsinc/pylon 0.1.0 → 0.1.2

package/README.md

@@ -1,14 +1,19 @@
 # `@openagentsinc/pylon`
 
 Bootstrap the latest tagged standalone `Pylon` release asset from GitHub
-Releases and run the first-run smoke path 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.1.0
-npx @openagentsinc/pylon --model gemma-4-e2b --diagnostic-repeats 2
+npx @openagentsinc/pylon --version 0.0.1-rc4
+npx @openagentsinc/pylon --no-launch
+npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --diagnostic-repeats 2
+npx @openagentsinc/pylon --verbose
 ```
 
 The launcher:
@@ -17,12 +22,23 @@ The launcher:
   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/`
+- prints status lines such as release resolution, runtime checks, and local
+  model scanning while it runs
 - 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
 
 ## Publish
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -6,6 +6,7 @@ import {
   DEFAULT_RELEASE_REPO,
   bootstrapInstalledPylon,
   ensureReleaseInstall,
+  launchInstalledPylonTui,
   renderBootstrapSummary,
 } from "./index.js";
 
@@ -17,28 +18,83 @@ function parseIntegerFlag(value, label) {
   return parsed;
 }
 
+function createTerminalStyles(enableColor) {
+  if (!enableColor) {
+    return {
+      bold: (value) => value,
+      cyan: (value) => value,
+      dim: (value) => value,
+      green: (value) => value,
+      red: (value) => value,
+      yellow: (value) => value,
+    };
+  }
+
+  const wrap = (open, close) => (value) => `${open}${value}${close}`;
+  return {
+    bold: wrap("\u001B[1m", "\u001B[22m"),
+    cyan: wrap("\u001B[36m", "\u001B[39m"),
+    dim: wrap("\u001B[2m", "\u001B[22m"),
+    green: wrap("\u001B[32m", "\u001B[39m"),
+    red: wrap("\u001B[31m", "\u001B[39m"),
+    yellow: wrap("\u001B[33m", "\u001B[39m"),
+  };
+}
+
+function createReporter({ enableColor = process.stdout.isTTY && !process.env.NO_COLOR } = {}) {
+  const styles = createTerminalStyles(enableColor);
+  return {
+    status({ message, detail = null }) {
+      const prefix = styles.cyan("›");
+      const suffix = detail ? ` ${styles.dim(detail)}` : "";
+      console.log(`${prefix} ${styles.bold(message)}${suffix}`);
+    },
+    success(message, detail = null) {
+      const suffix = detail ? ` ${styles.dim(detail)}` : "";
+      console.log(`${styles.green("✓")} ${styles.bold(message)}${suffix}`);
+    },
+    warning(message, detail = null) {
+      const suffix = detail ? ` ${styles.dim(detail)}` : "";
+      console.log(`${styles.yellow("!")} ${styles.bold(message)}${suffix}`);
+    },
+    failure(message, detail = null) {
+      const suffix = detail ? ` ${styles.dim(detail)}` : "";
+      console.error(`${styles.red("x")} ${styles.bold(message)}${suffix}`);
+    },
+  };
+}
+
 export function usage() {
   return `Usage:
   npx @openagentsinc/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, and run the first-run smoke path.
+  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.
 
 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:
@@ -59,8 +115,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,
   };
@@ -98,6 +156,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],
@@ -116,6 +177,13 @@ export function parseArgs(argv) {
       case "--skip-diagnostics":
         options.skipDiagnostics = true;
         break;
+      case "--no-launch":
+        options.noLaunch = true;
+        break;
+      case "--verbose":
+      case "--debug-network":
+        options.verbose = true;
+        break;
       case "--json":
         options.json = true;
         break;
@@ -144,26 +212,58 @@ export function parseArgs(argv) {
 }
 
 export async function main(argv = process.argv.slice(2), dependencies = {}) {
+  const {
+    ensureReleaseInstallImpl = ensureReleaseInstall,
+    bootstrapInstalledPylonImpl = bootstrapInstalledPylon,
+    launchInstalledPylonTuiImpl = launchInstalledPylonTui,
+  } = dependencies;
   const options = parseArgs(argv);
   if (options.help) {
     console.log(usage());
     return null;
   }
 
-  const install = await ensureReleaseInstall(options, dependencies);
-  const summary = await bootstrapInstalledPylon(
+  const reporter = options.json ? null : createReporter();
+
+  const install = await ensureReleaseInstallImpl(options, {
+    ...dependencies,
+    onStatus: reporter?.status,
+  });
+  const summary = await bootstrapInstalledPylonImpl(
     {
       ...options,
       ...install,
       version: install.version,
     },
-    dependencies,
+    {
+      ...dependencies,
+      onStatus: reporter?.status,
+    },
   );
 
   if (options.json) {
     console.log(JSON.stringify(summary, null, 2));
   } else {
+    reporter?.success("Pylon bootstrap complete");
     console.log(renderBootstrapSummary(summary));
+    if (!options.noLaunch) {
+      await launchInstalledPylonTuiImpl(
+        {
+          ...options,
+          ...install,
+          version: install.version,
+        },
+        {
+          ...dependencies,
+          onStatus: reporter?.status,
+        },
+      );
+    } else {
+      reporter?.warning(
+        "Skipped Pylon terminal UI launch",
+        "pass no flag to open pylon-tui by default",
+      );
+    }
   }
   return summary;
 }