@peer-agent/cli 0.0.1-beta.49 → 0.0.2-beta.1

package/README.md

@@ -32,6 +32,18 @@ Requires **Node.js 20+**.
 
 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).
 
+## Automatic updates
+
+On an interactive launch, `peer` checks GitHub Releases in the background at most once every 24 hours. The check never blocks startup, is skipped in CI and non-TTY sessions, and silently preserves the current version when the network is unavailable.
+
+Stable versions follow stable Releases; beta versions follow prerelease Releases. When a newer matching version is available, the TUI asks for confirmation before changing anything:
+
+- npm installs upgrade with `npm install --global @peer-agent/cli@<version>`
+- pnpm installs upgrade with `pnpm add --global @peer-agent/cli@<version>`
+- direct GitHub Release installs download the matching archive and replace `peer` plus `peer-credential-helper` using staged files and rollback backups
+
+Press **Y** or **Enter** to confirm, or **N** / **Esc** to dismiss. Restart `peer` after a successful update. Automatic checks can be disabled with `PEER_AGENT_NO_UPDATE_CHECK=1`; manual reinstall commands continue to work.
+
 ## Supported platforms (today)
 
 | Platform | Archive | Notes |
@@ -45,6 +57,7 @@ Version is pinned to the npm package version (e.g. `@peer-agent/cli@0.0.1-beta.3
 |----------|--------|
 | `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_NO_UPDATE_CHECK=1` | Disable automatic background update checks |
 | `PEER_AGENT_RELEASE_BASE` | Override GitHub Releases base URL (tests / mirrors) |
 
 ## Monorepo developers

package/bin/peer.js

@@ -4,7 +4,7 @@
  * peer-credential-helper must live next to peer (same vendor/ directory).
  */
 import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -36,9 +36,19 @@ if (!existsSync(binary) || !existsSync(helper)) {
   process.exit(1);
 }
 
+let installSource = 'npm';
+try {
+  const metadata = JSON.parse(
+    readFileSync(join(vendor, '.peer-agent-install.json'), 'utf8'),
+  );
+  if (metadata.source === 'pnpm') installSource = 'pnpm';
+} catch {
+  // Older installs predate source metadata; npm is the conservative default.
+}
+
 const child = spawn(binary, process.argv.slice(2), {
   stdio: 'inherit',
-  env: process.env,
+  env: { ...process.env, PEER_AGENT_INSTALL_SOURCE: installSource },
   windowsHide: true,
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peer-agent/cli",
-  "version": "0.0.1-beta.49",
+  "version": "0.0.2-beta.1",
   "description": "Peer Agent CLI — install via npm; downloads the platform peer binary from GitHub Releases.",
   "publishConfig": {
     "access": "public"

package/scripts/postinstall.mjs

@@ -3,7 +3,7 @@
  * 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 { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { installBinary } from '../lib/install-binary.mjs';
@@ -31,6 +31,12 @@ try {
     root,
     log: (msg) => console.log(msg),
   });
+  const userAgent = process.env.npm_config_user_agent ?? '';
+  const packageManager = userAgent.startsWith('pnpm/') ? 'pnpm' : 'npm';
+  writeFileSync(
+    join(root, 'vendor', '.peer-agent-install.json'),
+    `${JSON.stringify({ source: packageManager, packageName: pkg.name })}\n`,
+  );
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`[@peer-agent/cli] postinstall failed: ${message}`);