@aptove/aptove 0.1.4 → 0.1.6

package/README.md

@@ -126,16 +126,31 @@ Images are published to `ghcr.io/aptove/aptove-agent` on every release.
 # Pull the latest multi-arch image (amd64 + arm64)
 docker pull ghcr.io/aptove/aptove-agent:latest
 
-# Run interactively with config and API key
+# Chat mode — Linux host
 docker run --rm -it \
   -v ~/.config/Aptove:/root/.config/Aptove \
   -e ANTHROPIC_API_KEY=... \
   ghcr.io/aptove/aptove-agent:latest chat
 
-# ACP stdio mode (for use with the bridge)
+# Chat mode — macOS host (config lives under ~/Library/Application Support/Aptove)
+docker run --rm -it \
+  -v "$HOME/Library/Application Support/Aptove":/root/.config/Aptove \
+  -e ANTHROPIC_API_KEY=... \
+  ghcr.io/aptove/aptove-agent:latest chat
+
+# Bridge mode with QR code for mobile pairing
+# --advertise-addr is required in containers: the container gets an internal virtual IP
+# that mobile devices cannot reach. Pass your host machine's real LAN IP instead.
+docker run --rm -it \
+  -p 8765:8765 \
+  -v "$HOME/Library/Application Support/Aptove":/root/.config/Aptove \
+  -e ANTHROPIC_API_KEY=... \
+  ghcr.io/aptove/aptove-agent:latest run --qr --advertise-addr 192.168.1.50
+
+# ACP stdio mode (for use with an external bridge)
 docker run --rm -i \
   -e ANTHROPIC_API_KEY=... \
-  ghcr.io/aptove/aptove-agent:latest run
+  ghcr.io/aptove/aptove-agent:latest stdio
 ```
 
 Works on Linux natively and on Windows via Docker Desktop (WSL2 backend).
@@ -148,11 +163,14 @@ Apple Native runs Linux containers directly via the macOS Virtualization.framewo
 # Install the container CLI
 brew install container  # requires arm64 + macOS 26 (Tahoe)
 
-# Run
-container run \
-  -v ~/.config/Aptove:/root/.config/Aptove \
+# Run (macOS config lives under ~/Library/Application Support/Aptove)
+# Use --advertise-addr with your Mac's real LAN IP for local transport QR pairing
+container run -it \
+  --dns 8.8.8.8 \
+  -p 8765:8765 \
+  -v "$HOME/Library/Application Support/Aptove":/root/.config/Aptove \
   -e ANTHROPIC_API_KEY=... \
-  ghcr.io/aptove/aptove-agent:latest-darwin-arm64 chat
+  ghcr.io/aptove/aptove-agent:0.1.4-darwin-arm64 run --qr --advertise-addr 192.168.1.50
 ```
 
 ### Available Tags

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptove/aptove",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ACP AI coding agent — connects to Claude, Gemini, and OpenAI",
   "license": "Apache-2.0",
   "repository": {
@@ -35,10 +35,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@aptove/aptove-darwin-arm64": "0.1.4",
-    "@aptove/aptove-darwin-x64": "0.1.4",
-    "@aptove/aptove-linux-arm64": "0.1.4",
-    "@aptove/aptove-linux-x64": "0.1.4",
-    "@aptove/aptove-win32-x64": "0.1.4"
+    "@aptove/aptove-darwin-arm64": "0.1.6",
+    "@aptove/aptove-darwin-x64": "0.1.6",
+    "@aptove/aptove-linux-arm64": "0.1.6",
+    "@aptove/aptove-linux-x64": "0.1.6",
+    "@aptove/aptove-win32-x64": "0.1.6"
   }
 }

package/postinstall.js

@@ -1,8 +1,9 @@
 /**
  * aptove postinstall script
  *
- * Verifies the correct platform-specific package was installed
- * and the binary is executable.
+ * Ensures the correct platform-specific binary package is installed.
+ * npm sometimes skips optional dependencies during global installs, so
+ * we detect this and install the platform package explicitly if needed.
  */
 
 const { execSync } = require('child_process');
@@ -17,43 +18,81 @@ const PLATFORM_PACKAGES = {
   'win32-x64':    '@aptove/aptove-win32-x64',
 };
 
-function main() {
+function getPlatformPackage() {
   const platformKey = `${process.platform}-${process.arch}`;
-  const packageName = PLATFORM_PACKAGES[platformKey];
+  return { platformKey, packageName: PLATFORM_PACKAGES[platformKey] };
+}
+
+function isBinaryInstalled(packageName) {
+  try {
+    const packagePath = require.resolve(`${packageName}/package.json`);
+    const binaryName = process.platform === 'win32' ? 'aptove.exe' : 'aptove';
+    const binaryPath = path.join(path.dirname(packagePath), 'bin', binaryName);
+    return fs.existsSync(binaryPath);
+  } catch (e) {
+    return false;
+  }
+}
+
+function getPackageVersion() {
+  try {
+    const pkg = require('./package.json');
+    // optionalDependencies values are updated by the release workflow to match the published version
+    const deps = pkg.optionalDependencies || {};
+    const versions = Object.values(deps).filter(v => v !== '*');
+    return versions[0] || pkg.version;
+  } catch (e) {
+    return 'latest';
+  }
+}
+
+function installPlatformPackage(packageName, version) {
+  // During `npm install -g`, npm_config_prefix points to the global prefix (e.g. /usr/local or ~/.nvm/...).
+  // Installing with --prefix ensures the package lands in the same global node_modules tree.
+  const prefix = process.env.npm_config_prefix;
+  const prefixFlag = prefix ? `--prefix "${prefix}"` : '';
+
+  console.log(`  Installing ${packageName}@${version}...`);
+  execSync(
+    `npm install ${prefixFlag} --no-save --no-audit --no-fund "${packageName}@${version}"`,
+    { stdio: 'inherit' }
+  );
+}
+
+function main() {
+  const { platformKey, packageName } = getPlatformPackage();
 
   if (!packageName) {
     console.warn(`⚠️  aptove: Unsupported platform ${platformKey}`);
-    console.warn('   Supported platforms: darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-x64');
+    console.warn('   Supported: darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-x64');
     return;
   }
 
-  try {
-    const packagePath = require.resolve(`${packageName}/package.json`);
-    const binaryName = process.platform === 'win32' ? 'aptove.exe' : 'aptove';
-    const binaryPath = path.join(path.dirname(packagePath), 'bin', binaryName);
+  if (isBinaryInstalled(packageName)) {
+    console.log(`✓ aptove installed successfully for ${platformKey}`);
+    return;
+  }
+
+  // Optional dependency was not installed (common with `npm install -g`).
+  // Install it explicitly.
+  console.log(`⬇  aptove: platform package not found, installing ${packageName}...`);
+  const version = getPackageVersion();
 
-    if (!fs.existsSync(binaryPath)) {
-      console.warn(`⚠️  aptove: Binary not found at ${binaryPath}`);
-      return;
-    }
-
-    if (process.platform !== 'win32') {
-      try {
-        fs.chmodSync(binaryPath, 0o755);
-      } catch (e) {
-        // Not critical
-      }
-    }
-
-    try {
-      execSync(`"${binaryPath}" --version`, { stdio: 'pipe' });
-      console.log(`✓ aptove installed successfully for ${platformKey}`);
-    } catch (e) {
-      console.warn(`⚠️  aptove: Binary exists but failed to execute on ${platformKey}`);
-    }
+  try {
+    installPlatformPackage(packageName, version);
   } catch (e) {
-    console.warn(`⚠️  aptove: Platform package ${packageName} not installed`);
-    console.warn('   This is expected on CI or unsupported platforms');
+    console.error(`✗ aptove: failed to install ${packageName}@${version}`);
+    console.error(`  You can install it manually with:`);
+    console.error(`    npm install -g ${packageName}@${version}`);
+    process.exit(1);
+  }
+
+  if (isBinaryInstalled(packageName)) {
+    console.log(`✓ aptove installed successfully for ${platformKey}`);
+  } else {
+    console.error(`✗ aptove: binary not found after installing ${packageName}`);
+    console.error(`  Try: npm install -g ${packageName}@${version}`);
+    process.exit(1);
   }
 }