agent-afk 1.0.0 → 1.0.1

package/dist/postinstall.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * postinstall.mjs — Runs after `npm install` to check whether the npm bin
+ * directory is on PATH and prints a remediation hint if not.
+ *
+ * Named export `detectPathGap` is a pure function for unit testing.
+ * The main block is guarded by an import.meta.url check so this file can be
+ * imported in tests without triggering the subprocess/print side-effects.
+ *
+ * Always exits 0 — never fails an install.
+ */
+
+import { execSync } from 'node:child_process';
+
+/**
+ * Pure function. Determines whether the npm bin directory is on PATH.
+ *
+ * @param {string} prefix   - Result of `npm config get prefix` (may have trailing slash)
+ * @param {string} pathEnv  - The PATH string to check against (e.g. process.env.PATH)
+ * @returns {{ onPath: boolean, binDir: string }}
+ */
+export function detectPathGap(prefix, pathEnv) {
+  const normalizedPrefix = prefix.trim().replace(/\/$/, '');
+  const binDir = `${normalizedPrefix}/bin`;
+  const pathParts = (pathEnv ?? '').split(':').map((p) => p.replace(/\/$/, ''));
+  const onPath = pathParts.includes(binDir);
+  return { onPath, binDir };
+}
+
+// ─── Main block ─────────────────────────────────────────────────────────────
+// Guard: only run when executed directly (not when imported by tests).
+const isMain =
+  typeof process !== 'undefined' &&
+  typeof process.argv !== 'undefined' &&
+  import.meta.url === `file://${process.argv[1]}`;
+
+if (isMain) {
+  // Only meaningful on macOS/Linux where PATH-based installs are common.
+  if (process.platform === 'win32') {
+    process.exit(0);
+  }
+
+  try {
+    const prefix = execSync('npm config get prefix', {
+      timeout: 2000,
+      encoding: 'utf-8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+
+    const { onPath, binDir } = detectPathGap(prefix, process.env['PATH'] ?? '');
+
+    if (!onPath) {
+      const shell = process.env['SHELL'] ?? '';
+      const rcFile = shell.includes('zsh')
+        ? '~/.zshrc'
+        : shell.includes('fish')
+          ? '~/.config/fish/config.fish'
+          : '~/.bashrc';
+
+      const exportLine =
+        shell.includes('fish')
+          ? `fish_add_path ${binDir}`
+          : `export PATH="${binDir}:$PATH"`;
+
+      process.stdout.write(
+        [
+          '',
+          '┌─────────────────────────────────────────────────────────────┐',
+          '│  agent-afk: npm bin directory is not on your PATH          │',
+          '│                                                             │',
+          `│  Run this to fix it:                                        │`,
+          `│    echo '${exportLine}' >> ${rcFile}`,
+          '│    source ' + rcFile + '                                              │',
+          '│                                                             │',
+          '│  Or add this line to your shell profile manually:          │',
+          `│    ${exportLine}`,
+          '└─────────────────────────────────────────────────────────────┘',
+          '',
+        ].join('\n'),
+      );
+    }
+  } catch {
+    // execSync failed (npm not found, timeout, etc.) — silently ignore.
+  }
+
+  process.exit(0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-afk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI tool for interacting with AI agents via multiple interfaces",
   "main": "dist/index.mjs",
   "type": "module",
@@ -11,6 +11,7 @@
     "dist/"
   ],
   "scripts": {
+    "postinstall": "node dist/postinstall.mjs || true",
     "build": "tsc && node scripts/copy-prompts.js",
     "dev": "tsx watch src/cli/index.ts",
     "start": "node dist/cli/index.js",