@peer-agent/cli 0.0.1-beta.40

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 梁音
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @peer-agent/cli
+
+Install the Peer Agent terminal CLI with npm or pnpm. This package is a thin installer:
+
+1. `postinstall` downloads `peer` + `peer-credential-helper` for your platform from the matching GitHub Release
+2. the `peer` bin launches the vendor binary (helper must stay next to `peer`)
+
+> Monorepo note: the TUI **source** package is `@peer-agent/tui` (`apps/tui`).  
+> This package (`@peer-agent/cli`) is the **public npm installer** only.
+
+## Install
+
+```bash
+npm install -g @peer-agent/cli
+# or
+pnpm add -g @peer-agent/cli
+```
+
+```bash
+peer --version
+peer
+```
+
+Requires **Node.js 20+**.
+
+## What gets installed
+
+| File | Role |
+|------|------|
+| `vendor/peer` | CLI / TUI binary |
+| `vendor/peer-credential-helper` | credential vault helper (must be same directory as `peer`) |
+
+Version is pinned to the npm package version (e.g. `@peer-agent/cli@0.0.1-beta.38` downloads the `v0.0.1-beta.38` GitHub Release asset).
+
+## Supported platforms (today)
+
+| Platform | Archive | Notes |
+|----------|---------|-------|
+| macOS arm64 | `peer-darwin-arm64.tar.gz` | First-class |
+| other | — | postinstall fails with a clear error until multi-platform CLI ships |
+
+## Environment variables
+
+| Variable | Effect |
+|----------|--------|
+| `PEER_AGENT_SKIP_DOWNLOAD=1` | Skip binary download (CI publish / offline) |
+| `PEER_AGENT_FORCE_DOWNLOAD=1` | Force download even inside the monorepo checkout |
+| `PEER_AGENT_RELEASE_BASE` | Override GitHub Releases base URL (tests / mirrors) |
+
+## Monorepo developers
+
+Inside this repository, `postinstall` **does not** download binaries by default (it detects `apps/tui`). Build the real CLI with:
+
+```bash
+pnpm --filter @peer-agent/tui build
+./apps/tui/dist/peer --version
+```
+
+To force the installer path locally:
+
+```bash
+PEER_AGENT_FORCE_DOWNLOAD=1 node packages/npm-cli/scripts/postinstall.mjs
+```
+
+## Manual install (no npm)
+
+From the GitHub Release for the same version:
+
+```bash
+tar -xzf peer-darwin-arm64.tar.gz
+export PATH="$PWD/peer-darwin-arm64:$PATH"
+peer --version
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g @peer-agent/cli
+```
+
+User data under `~/.peer-agent` is **not** removed (shared with Desktop).
+
+## License
+
+MIT — same as the Peer Agent monorepo.

package/bin/peer.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * npm bin shim — exec the vendor peer binary downloaded by postinstall.
+ * peer-credential-helper must live next to peer (same vendor/ directory).
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const vendor = join(root, 'vendor');
+const binary = join(vendor, process.platform === 'win32' ? 'peer.exe' : 'peer');
+const helper = join(
+  vendor,
+  process.platform === 'win32' ? 'peer-credential-helper.exe' : 'peer-credential-helper',
+);
+
+if (!existsSync(binary) || !existsSync(helper)) {
+  console.error(
+    [
+      '[@peer-agent/cli] CLI binaries are missing.',
+      `  expected: ${binary}`,
+      `  expected: ${helper}`,
+      '',
+      'postinstall should have downloaded them from GitHub Releases.',
+      'Try reinstalling:',
+      '  npm i -g @peer-agent/cli',
+      'or set PEER_AGENT_RELEASE_URL to a direct archive URL and reinstall.',
+      '',
+      'Manual fallback: download peer-*-*.tar.gz from',
+      '  https://github.com/yinLiangDream/Peer-Agent/releases',
+      'and keep peer + peer-credential-helper in the same directory.',
+    ].join('\n'),
+  );
+  process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env,
+  windowsHide: true,
+});
+
+child.on('error', (error) => {
+  console.error(`[@peer-agent/cli] failed to start peer: ${error.message}`);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/lib/install-binary.mjs

@@ -0,0 +1,196 @@
+import { spawnSync } from 'node:child_process';
+import {
+  chmodSync,
+  copyFileSync,
+  createWriteStream,
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  statSync,
+  writeFileSync,
+} from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { peerBinaryPath, helperBinaryPath, vendorDir } from './paths.mjs';
+import { releaseAssetUrl, resolvePlatformTarget } from './platform.mjs';
+
+/**
+ * @param {{
+ *   version: string,
+ *   root?: string,
+ *   platform?: string,
+ *   arch?: string,
+ *   fetchImpl?: typeof fetch,
+ *   skipDownload?: boolean,
+ *   force?: boolean,
+ *   log?: (msg: string) => void,
+ * }} options
+ */
+export async function installBinary(options) {
+  const log = options.log ?? ((msg) => console.log(msg));
+  const root = options.root;
+  if (!root) throw new Error('installBinary: root is required');
+  const version = options.version;
+  if (!version) throw new Error('installBinary: version is required');
+
+  if (options.skipDownload || process.env.PEER_AGENT_SKIP_DOWNLOAD === '1') {
+    log('[@peer-agent/cli] PEER_AGENT_SKIP_DOWNLOAD=1 — skipping binary download');
+    return { skipped: true, reason: 'skip-download' };
+  }
+
+  const target = resolvePlatformTarget(options.platform, options.arch);
+  if (!target) {
+    throw new Error(
+      `Unsupported platform ${options.platform ?? process.platform}/${options.arch ?? process.arch}. ` +
+        'Peer Agent npm CLI currently supports platforms published on GitHub Releases.',
+    );
+  }
+  if (!target.supported) {
+    throw new Error(
+      `Platform ${target.os}-${target.arch} is recognized but not yet published as a Release asset ` +
+        `(expected ${target.archive}). Download a manual archive from GitHub Releases, or wait for multi-platform CLI builds.`,
+    );
+  }
+
+  const vendor = vendorDir(root);
+  const peerPath = peerBinaryPath(root);
+  const helperPath = helperBinaryPath(root);
+  const markerPath = join(vendor, '.peer-agent-version');
+
+  if (
+    !options.force &&
+    existsSync(peerPath) &&
+    existsSync(helperPath) &&
+    existsSync(markerPath) &&
+    readFileSync(markerPath, 'utf8').trim() === version
+  ) {
+    log(`[@peer-agent/cli] vendor binaries already present for ${version}`);
+    return { skipped: true, reason: 'already-installed', peerPath, helperPath };
+  }
+
+  const url = process.env.PEER_AGENT_RELEASE_URL || releaseAssetUrl(version, target);
+  log(`[@peer-agent/cli] downloading ${url}`);
+
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  if (typeof fetchImpl !== 'function') {
+    throw new Error('fetch is not available; Node.js 20+ is required');
+  }
+
+  const response = await fetchImpl(url, {
+    headers: { 'User-Agent': `@peer-agent/cli/${version}` },
+    redirect: 'follow',
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download CLI archive (${response.status} ${response.statusText}): ${url}\n` +
+        'Check that this version published peer-darwin-arm64.tar.gz on GitHub Releases.',
+    );
+  }
+
+  const tmp = mkdtempSync(join(tmpdir(), 'peer-agent-npm-'));
+  const archivePath = join(tmp, target.archive);
+  try {
+    const body = response.body;
+    if (!body) throw new Error('Empty response body from GitHub Releases');
+    await pipeline(body, createWriteStream(archivePath));
+
+    const extractDir = join(tmp, 'extract');
+    mkdirSync(extractDir, { recursive: true });
+    extractArchive(archivePath, extractDir, target.archive);
+
+    const found = findBinaries(extractDir);
+    if (!found.peer || !found.helper) {
+      throw new Error(
+        `Archive did not contain peer + peer-credential-helper (found peer=${Boolean(found.peer)} helper=${Boolean(found.helper)})`,
+      );
+    }
+
+    mkdirSync(vendor, { recursive: true });
+    copyFileSync(found.peer, peerPath);
+    copyFileSync(found.helper, helperPath);
+    try {
+      chmodSync(peerPath, 0o755);
+      chmodSync(helperPath, 0o755);
+    } catch {
+      // Windows no-op
+    }
+    writeFileSync(markerPath, `${version}\n`);
+
+    log(`[@peer-agent/cli] installed peer + peer-credential-helper → ${vendor}`);
+    return { skipped: false, peerPath, helperPath, url };
+  } finally {
+    rmSync(tmp, { recursive: true, force: true });
+  }
+}
+
+/**
+ * @param {string} archivePath
+ * @param {string} extractDir
+ * @param {string} archiveName
+ */
+function extractArchive(archivePath, extractDir, archiveName) {
+  if (archiveName.endsWith('.tar.gz') || archiveName.endsWith('.tgz')) {
+    const result = spawnSync('tar', ['-xzf', archivePath, '-C', extractDir], {
+      encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+      throw new Error(`tar extract failed: ${result.stderr || result.stdout || result.status}`);
+    }
+    return;
+  }
+  if (archiveName.endsWith('.zip')) {
+    // Prefer system unzip when present (stage-2 windows).
+    const result = spawnSync('unzip', ['-o', archivePath, '-d', extractDir], {
+      encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+      throw new Error(
+        `unzip extract failed: ${result.stderr || result.stdout || result.status}. ` +
+          'Install unzip or use a tar.gz asset.',
+      );
+    }
+    return;
+  }
+  throw new Error(`Unsupported archive format: ${archiveName}`);
+}
+
+/**
+ * Walk extract tree for peer + helper (archive may nest peer-darwin-arm64/).
+ * @param {string} dir
+ * @returns {{ peer: string | null, helper: string | null }}
+ */
+export function findBinaries(dir) {
+  let peer = null;
+  let helper = null;
+  const stack = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (!current) break;
+    let entries;
+    try {
+      entries = readdirSync(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(full);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (entry.name === 'peer' || entry.name === 'peer.exe') peer = full;
+      if (entry.name === 'peer-credential-helper' || entry.name === 'peer-credential-helper.exe') {
+        helper = full;
+      }
+    }
+  }
+  // Prefer executable-looking files when duplicates exist
+  if (peer && !statSync(peer).isFile()) peer = null;
+  if (helper && !statSync(helper).isFile()) helper = null;
+  return { peer, helper };
+}

package/lib/paths.mjs

@@ -0,0 +1,24 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** Absolute package root for packages/npm-cli. */
+export function packageRoot(fromUrl = import.meta.url) {
+  // lib/paths.mjs → package root is parent of lib/
+  return join(dirname(fileURLToPath(fromUrl)), '..');
+}
+
+/** Directory that holds peer + peer-credential-helper after postinstall. */
+export function vendorDir(root = packageRoot()) {
+  return join(root, 'vendor');
+}
+
+export function peerBinaryPath(root = packageRoot()) {
+  return join(vendorDir(root), process.platform === 'win32' ? 'peer.exe' : 'peer');
+}
+
+export function helperBinaryPath(root = packageRoot()) {
+  return join(
+    vendorDir(root),
+    process.platform === 'win32' ? 'peer-credential-helper.exe' : 'peer-credential-helper',
+  );
+}

package/lib/platform.mjs

@@ -0,0 +1,68 @@
+/**
+ * Map Node process.platform / process.arch to the GitHub Release CLI archive name.
+ *
+ * Stage-1 release assets currently ship only peer-darwin-arm64.tar.gz.
+ * Platform keys below include forward-looking names so installers can fail with a
+ * precise "not yet published" message instead of inventing a wrong URL.
+ */
+
+/** @typedef {{ os: string, arch: string, archive: string, supported: boolean }} PlatformTarget */
+
+const TARGETS = {
+  'darwin-arm64': {
+    os: 'darwin',
+    arch: 'arm64',
+    archive: 'peer-darwin-arm64.tar.gz',
+    supported: true,
+  },
+  'darwin-x64': {
+    os: 'darwin',
+    arch: 'x64',
+    archive: 'peer-darwin-x64.tar.gz',
+    supported: false,
+  },
+  'linux-arm64': {
+    os: 'linux',
+    arch: 'arm64',
+    archive: 'peer-linux-arm64.tar.gz',
+    supported: false,
+  },
+  'linux-x64': {
+    os: 'linux',
+    arch: 'x64',
+    archive: 'peer-linux-x64.tar.gz',
+    supported: false,
+  },
+  'win32-x64': {
+    os: 'win32',
+    arch: 'x64',
+    archive: 'peer-win32-x64.zip',
+    supported: false,
+  },
+};
+
+/**
+ * @param {string} [platform]
+ * @param {string} [arch]
+ * @returns {PlatformTarget | null}
+ */
+export function resolvePlatformTarget(platform = process.platform, arch = process.arch) {
+  const key = `${platform}-${arch}`;
+  return TARGETS[key] ?? null;
+}
+
+/**
+ * @param {string} version semver without leading v
+ * @param {PlatformTarget} target
+ * @param {{ owner?: string, repo?: string }} [opts]
+ */
+export function releaseAssetUrl(version, target, opts = {}) {
+  const owner = opts.owner ?? process.env.PEER_AGENT_GITHUB_OWNER ?? 'yinLiangDream';
+  const repo = opts.repo ?? process.env.PEER_AGENT_GITHUB_REPO ?? 'Peer-Agent';
+  const tag = version.startsWith('v') ? version : `v${version}`;
+  return `https://github.com/${owner}/${repo}/releases/download/${tag}/${target.archive}`;
+}
+
+export function listKnownTargets() {
+  return Object.values(TARGETS);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@peer-agent/cli",
+  "version": "0.0.1-beta.40",
+  "description": "Peer Agent CLI — install via npm; downloads the platform peer binary from GitHub Releases.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "peer": "bin/peer.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
+    "test": "node --test test/*.test.mjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yinLiangDream/Peer-Agent.git",
+    "directory": "packages/npm-cli"
+  },
+  "homepage": "https://github.com/yinLiangDream/Peer-Agent#readme",
+  "bugs": {
+    "url": "https://github.com/yinLiangDream/Peer-Agent/issues"
+  },
+  "keywords": [
+    "peer-agent",
+    "cli",
+    "ai-agent",
+    "tui"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * postinstall — download peer + peer-credential-helper for the current platform
+ * from the matching GitHub Release (package version == release tag without v).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { installBinary } from '../lib/install-binary.mjs';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+const version = pkg.version;
+
+// Monorepo checkout: packages/npm-cli lives next to apps/tui — developers build
+// peer locally; do not hit GitHub on every pnpm install unless forced.
+const monorepoMarker = join(root, '../../apps/tui/package.json');
+const inMonorepo = existsSync(monorepoMarker);
+const forceDownload = process.env.PEER_AGENT_FORCE_DOWNLOAD === '1';
+if (inMonorepo && !forceDownload) {
+  console.log(
+    '[@peer-agent/cli] monorepo install detected — skipping binary download ' +
+      '(set PEER_AGENT_FORCE_DOWNLOAD=1 to fetch Release assets anyway)',
+  );
+  process.exit(0);
+}
+
+try {
+  await installBinary({
+    version,
+    root,
+    log: (msg) => console.log(msg),
+  });
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[@peer-agent/cli] postinstall failed: ${message}`);
+  console.error(
+    '[@peer-agent/cli] You can still install manually from GitHub Releases: ' +
+      `https://github.com/yinLiangDream/Peer-Agent/releases/tag/v${version}`,
+  );
+  // Fail install so global users notice missing binaries instead of a broken `peer`.
+  process.exit(1);
+}