@brickhouse-tech/sync-agents 0.1.17 → 0.2.1

package/README.md

@@ -18,7 +18,11 @@ or globally:
 npm install -g @brickhouse-tech/sync-agents
 ```
 
-### Standalone (no npm required)
+### Standalone (no npm required) — deprecated
+
+> **Deprecated.** The bash script is kept as a fallback for unsupported
+> triples but will be removed in a future major. Prefer the npm install
+> above; it ships native Go binaries via per-platform optional packages.
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/brickhouse-tech/sync-agents/main/src/sh/sync-agents.sh -o /usr/local/bin/sync-agents

package/bin/sync-agents.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Launcher: prefer the Go binary shipped via the matching platform package
+// (@brickhouse-tech/sync-agents-<os>-<arch>); fall back to the bash script
+// at src/sh/sync-agents.sh so the package never bricks on an unsupported
+// triple.
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+
+const platformPkg = `@brickhouse-tech/sync-agents-${process.platform}-${process.arch}`;
+const exe = process.platform === "win32" ? "sync-agents.exe" : "sync-agents";
+
+function resolveGoBinary() {
+  try {
+    const pkgJson = require.resolve(`${platformPkg}/package.json`);
+    const candidate = path.join(path.dirname(pkgJson), "bin", exe);
+    if (fs.existsSync(candidate)) return candidate;
+  } catch {
+    // platform package not installed (npm skipped it via os/cpu mismatch
+    // or it failed as an optionalDependency); fall through to bash.
+  }
+  return null;
+}
+
+function fallbackShellScript() {
+  return path.join(__dirname, "..", "src", "sh", "sync-agents.sh");
+}
+
+const target = resolveGoBinary() ?? fallbackShellScript();
+const isShell = target.endsWith(".sh");
+
+const result = spawnSync(isShell ? "bash" : target, isShell ? [target, ...process.argv.slice(2)] : process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(`sync-agents: failed to exec ${target}: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status ?? 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brickhouse-tech/sync-agents",
-  "version": "0.1.17",
+  "version": "0.2.1",
   "description": "Simple scripts to DRY up common agent interactions across multiple LLM providers.",
   "keywords": [
     "agents",
@@ -20,11 +20,19 @@
   },
   "author": "Nicholas McCready",
   "bin": {
-    "sync-agents": "src/sh/sync-agents.sh"
+    "sync-agents": "bin/sync-agents.js"
   },
   "files": [
+    "bin/sync-agents.js",
     "src/**/*"
   ],
+  "optionalDependencies": {
+    "@brickhouse-tech/sync-agents-darwin-arm64": "0.2.1",
+    "@brickhouse-tech/sync-agents-darwin-x64": "0.2.1",
+    "@brickhouse-tech/sync-agents-linux-arm64": "0.2.1",
+    "@brickhouse-tech/sync-agents-linux-x64": "0.2.1",
+    "@brickhouse-tech/sync-agents-win32-x64": "0.2.1"
+  },
   "overrides": {
     "file-type": ">=22",
     "picomatch": ">=4.0.4"
@@ -34,7 +42,9 @@
     "test": "npx concurrently --names \"sh,go\" -c \"cyan,magenta\" \"npm run test:sh\" \"npm run test:go\"",
     "test:sh": "npx bats test/",
     "test:go": "make test",
-    "prepare": "make install"
+    "prepare": "make install",
+    "prepack": "node scripts/sync-optional-deps.js",
+    "bootstrap:publish": "bash scripts/bootstrap-platform-publish.sh"
   },
   "devDependencies": {
     "@commitlint/cli": "^20",

package/src/sh/sync-agents.sh

@@ -1,4 +1,14 @@
 #!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# DEPRECATED — bash implementation of sync-agents.
+#
+# The Go binary shipped via per-platform npm packages is the supported
+# implementation. This shell script remains only as:
+#   - the fallback path in bin/sync-agents.js for unsupported triples
+#   - the standalone curl install in README (also deprecated)
+# Scheduled for removal in a future major after platform-package install
+# data shows the fallback is unused. Bug fixes go into go/, not here.
+# ----------------------------------------------------------------------------
 set -euo pipefail
 
 AGENTS_DIR=".agents"