agentworth 0.1.11 → 0.1.13

package/bin/agentworth.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 
+import path from 'node:path';
 import { run } from '../lib/resolver.js';
 
-const exitCode = run(process.argv.slice(2));
+// Both npm bin entries ('agentworth' and 'agwt', see package.json) point at this same
+// script -- process.argv[1] carries the name the shell actually resolved (the .bin
+// symlink), which is how we tell the two invocations apart without a second script.
+const invokedAs = path.basename(process.argv[1] || '').replace(/\.(js|cjs|mjs)$/, '');
+
+const exitCode = run(process.argv.slice(2), { invokedAs });
 process.exit(exitCode);

package/lib/resolver.js

@@ -35,9 +35,10 @@ export function getTargetTriple(platform = process.platform, arch = process.arch
   // Windows dropped 2026-09-02: release.yml no longer builds x86_64-pc-windows-msvc, so
   // this would 404 against the downloader even if it matched. The recurring failure was
   // GNU tar on Windows misparsing a "C:\..." archive path as a remote "host:path" tar
-  // spec -- fixable (--force-local), but broke across multiple releases regardless, and
-  // nobody here can test a real Windows box to catch it before it ships. A user who wants
-  // this on Windows can still build it themselves: `cargo build --release -p agentworth-cli`.
+  // spec -- no clean fix ever stuck (a --force-local attempt just broke macOS's BSD tar
+  // instead), and nobody here can test a real Windows box to catch it before it ships. A
+  // user who wants this on Windows can still build it themselves: `cargo build --release
+  // -p agentworth-cli`.
   return null;
 }
 
@@ -76,11 +77,19 @@ export function getCacheDir(version, homeDir) {
 /**
  * Returns the expected native binary name for the target platform.
  *
+ * `invokedAs` selects between the two native binaries the release tarball ships
+ * (`agentworth` and its `agwt` alias, see apps/cli/Cargo.toml's two [[bin]] targets) --
+ * anything other than exactly 'agwt' resolves to the `agentworth` binary, so an
+ * unrecognized or missing invocation name still gets the primary binary rather than
+ * silently 404ing on a name nobody built.
+ *
  * @param {string} [platform=process.platform]
+ * @param {string} [invokedAs] - basename the launcher was invoked as ('agentworth' or 'agwt')
  * @returns {string}
  */
-export function getBinaryName(platform = process.platform) {
-  return platform === 'win32' ? 'agentworth.exe' : 'agentworth';
+export function getBinaryName(platform = process.platform, invokedAs) {
+  const base = invokedAs === 'agwt' ? 'agwt' : 'agentworth';
+  return platform === 'win32' ? `${base}.exe` : base;
 }
 
 /**
@@ -221,6 +230,7 @@ function pathBinaryMatchesVersion(binPath, expected) {
  * @param {string} [options.version]
  * @param {string} [options.homeDir]
  * @param {boolean} [options.silent=false]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; picks which extracted binary is returned
  * @returns {Promise<string>} Path to extracted binary
  */
 export async function downloadAndExtractBinary(options = {}) {
@@ -228,7 +238,7 @@ export async function downloadAndExtractBinary(options = {}) {
   const arch = options.arch || process.arch;
   const version = options.version || getPackageVersion();
   const targetTriple = getTargetTriple(platform, arch);
-  const binName = getBinaryName(platform);
+  const binName = getBinaryName(platform, options.invokedAs);
 
   if (!targetTriple) {
     throw new Error(`Unsupported platform/architecture: ${platform}-${arch}`);
@@ -254,12 +264,12 @@ export async function downloadAndExtractBinary(options = {}) {
 
   await downloadFile(url, archivePath);
 
-  // Extract archive. --force-local matters on Windows: a drive-letter path like
-  // "C:\Users\...\agentworth.tar.gz" otherwise gets parsed as a "host:path" remote-tar
-  // spec (the "C" before the colon reads as a hostname), and tar tries to rsh/ssh to it
-  // instead of opening a local file.
+  // No --force-local here: it was a Windows-only GNU tar workaround, and Windows
+  // support was dropped in 8b837c3. BSD tar (macOS's default) doesn't recognize
+  // the flag and fails every extraction with it present -- v0.1.11 shipped this
+  // exact break. Keep it off; there's no platform left where it does anything.
   try {
-    execFileSync('tar', ['--force-local', '-xzf', archivePath, '-C', cacheDir]);
+    execFileSync('tar', ['-xzf', archivePath, '-C', cacheDir]);
   } catch (err) {
     throw new Error(`Failed to extract ${archiveName}: ${err.message}`);
   } finally {
@@ -368,6 +378,7 @@ export function findPathBinary(binName = getBinaryName(), pathEnv = process.env.
  * @param {NodeJS.ProcessEnv} [options.env=process.env]
  * @param {string} [options.baseDir=__dirname]
  * @param {string} [options.homeDir]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; selects which native binary to look for
  * @returns {{ found: boolean, path?: string, source?: string, error?: string }}
  */
 export function resolveBinary(options = {}) {
@@ -377,7 +388,7 @@ export function resolveBinary(options = {}) {
   const env = options.env || process.env;
   const baseDir = options.baseDir || __dirname;
   const homeDir = options.homeDir || (env.HOME ? env.HOME : os.homedir());
-  const binName = getBinaryName(platform);
+  const binName = getBinaryName(platform, options.invokedAs);
   const platformKey = getPlatformKey(platform, arch);
 
   // 1. Explicit environment variable override
@@ -509,11 +520,14 @@ export function formatMissingBinaryMessage(platformKey = getPlatformKey()) {
     '',
     'AgentWorth requires the native binary to run. You can install or build it via:',
     '',
-    '  \x1b[36m• Build from local source:\x1b[0m',
-    '      cargo build --release -p agentworth-cli',
+    '  \x1b[36m• Standalone install script:\x1b[0m',
+    '      curl -fsSL https://agentworth.dev/install.sh | sh',
+    '',
+    '  \x1b[36m• Cargo:\x1b[0m',
+    '      cargo install agentworth-cli',
     '',
-    '  \x1b[36m• Install via Cargo:\x1b[0m',
-    '      cargo install --path apps/cli',
+    '  \x1b[36m• Zero-install via npx:\x1b[0m',
+    '      npx -y agentworth',
     '',
     '  \x1b[36m• Download the release for your platform:\x1b[0m',
     `      https://github.com/unfoundbox-crew/agentworth/releases/latest`,
@@ -546,6 +560,7 @@ export function buildChildEnv(baseEnv, npmVersion) {
  *
  * @param {string[]} [argv=process.argv.slice(2)]
  * @param {Object} [options={}]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; which native binary to resolve
  * @returns {number} Exit code
  */
 export function run(argv = process.argv.slice(2), options = {}) {
@@ -561,7 +576,8 @@ export function run(argv = process.argv.slice(2), options = {}) {
         await downloadAndExtractBinary({
           platform: ${JSON.stringify(options.platform || process.platform)},
           arch: ${JSON.stringify(options.arch || process.arch)},
-          homeDir: ${JSON.stringify(options.homeDir || (options.env && options.env.HOME) || '')}
+          homeDir: ${JSON.stringify(options.homeDir || (options.env && options.env.HOME) || '')},
+          invokedAs: ${JSON.stringify(options.invokedAs || '')}
         });
       `;
       const dlResult = spawnSync(process.execPath, ['--input-type=module', '-e', syncDownloadScript], {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworth",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Discover, normalize, and understand AI-agent histories locally.",
   "type": "module",
   "main": "./lib/resolver.js",