@brrew/projectbridge 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# ProjectBridge Remote CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+ProjectBridge is proprietary software. All rights are reserved; npm publication makes the package installable but does not grant permission to copy, modify, redistribute, or create derivative works except where separately authorized by the copyright holder.
+
+## Install and run
+
+```sh
+npx --yes @brrew/projectbridge@latest remote
+```
+
+The CLI requests a short-lived pairing, opens the browser confirmation page, and waits for both browser confirmation and dashboard approval. After approval, it stores a device credential in a user-private configuration directory and sends periodic authenticated heartbeats.
+
+## Requirements
+
+- Node.js 20+
+- HTTPS access to the ProjectBridge server
+- The user must be signed in to the ProjectBridge dashboard to confirm the browser pairing and approve the host
+
+Set `PROJECTBRIDGE_SERVER` to use a different server. Set `PROJECTBRIDGE_CONFIG` to override the local config path.
+
+## Current limitations
+
+This is an early enrollment-only release. It establishes enrolled host presence and heartbeat only. It does **not** provide remote shell, filesystem access, process control, or an MCP remote execution channel. Do not treat it as a replacement for Desktop Commander. Those features, approval controls, auditing, and cross-platform acceptance tests remain to be implemented and tested.

package/bin/projectbridge.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+const { setTimeout: sleep } = require('node:timers/promises');
+
+const VERSION = '0.1.0';
+const DEFAULT_SERVER = (process.env.PROJECTBRIDGE_SERVER || 'https://projectbridge.brrew.us').replace(/\/$/, '');
+const UA = 'ProjectBridge-Remote/' + VERSION + ' (+https://projectbridge.brrew.us)';
+
+function configPath() {
+  if (process.env.PROJECTBRIDGE_CONFIG) return path.resolve(process.env.PROJECTBRIDGE_CONFIG);
+  if (process.platform === 'win32') return path.join(process.env.ProgramData || 'C:\\ProgramData', 'ProjectBridge', 'remote.json');
+  return path.join(os.homedir(), '.config', 'projectbridge', 'remote.json');
+}
+function hostInfo() {
+  return { hostname: os.hostname().slice(0,160), platform: process.platform === 'darwin' ? 'macOS' : process.platform === 'win32' ? 'Windows' : 'Linux',
+    os_version: os.version().slice(0,160), architecture: os.arch().slice(0,80), agent_version: VERSION };
+}
+async function request(base, route, body, credential) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 12000);
+  try {
+    const headers = { 'User-Agent': UA, 'Accept': 'application/json' };
+    if (body !== undefined) headers['Content-Type'] = 'application/json';
+    if (credential) headers.Authorization = 'Bearer ' + credential;
+    const response = await fetch(new URL(route, base), { method: body === undefined ? 'GET' : 'POST', headers,
+      body: body === undefined ? undefined : JSON.stringify(body), signal: controller.signal, redirect: 'error' });
+    const text = await response.text();
+    let data;
+    try { data = JSON.parse(text); } catch { throw new Error('Server returned a non-JSON response (HTTP ' + response.status + '). Check the server URL and access policy.'); }
+    if (!response.ok) throw new Error('ProjectBridge HTTP ' + response.status + ': ' + String(data.error || data.message || 'request failed'));
+    if (data.ok === false || data.error) throw new Error(String(data.error || 'ProjectBridge request failed'));
+    return data;
+  } finally { clearTimeout(timer); }
+}
+function openBrowser(url) {
+  let command, args;
+  if (process.platform === 'darwin') { command = 'open'; args = [url]; }
+  else if (process.platform === 'win32') { command = 'cmd'; args = ['/c','start','','"' + url.replace(/"/g,'') + '"']; }
+  else { command = 'xdg-open'; args = [url]; }
+  const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+  child.on('error', () => console.log('Open this confirmation URL manually:\n' + url));
+  child.unref();
+}
+async function saveConfig(config) {
+  const file = configPath();
+  await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+  await fs.writeFile(file, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+  if (process.platform !== 'win32') {
+    await fs.chmod(path.dirname(file), 0o700);
+    await fs.chmod(file, 0o600);
+  }
+  return file;
+}
+async function enroll(base) {
+  console.log('Requesting a temporary ProjectBridge pairing…');
+  const start = await request(base, '/api/enroll/start', hostInfo());
+  const pairing = start.result;
+  if (!pairing?.pairing_id || !pairing?.code || !pairing?.poll_token || !pairing?.callback_url) throw new Error('Enrollment response was incomplete.');
+  console.log('\nPairing code: ' + pairing.code);
+  console.log('This code expires in about ' + (pairing.expires_in || 300) + ' seconds.');
+  console.log('Confirm the code in your browser, then approve this host in the ProjectBridge dashboard.');
+  openBrowser(pairing.callback_url);
+  const deadline = Date.now() + Math.min(300, Math.max(30, Number(pairing.expires_in) || 300)) * 1000;
+  while (Date.now() < deadline) {
+    await sleep(4000);
+    const poll = await request(base, '/api/enroll/status', { pairing_id: pairing.pairing_id, code: pairing.code, poll_token: pairing.poll_token });
+    const result = poll.result;
+    if (result?.status === 'expired') throw new Error('Pairing expired. Run the command again to get a new code.');
+    if (result?.status === 'enrolled' && typeof result.credential === 'string' && result.credential.length >= 32) {
+      const file = await saveConfig({ server_url: base, device_credential: result.credential, heartbeat_interval_seconds: 30, agent_version: VERSION });
+      console.log('Host enrolled as ' + result.device_id + '. Protected config saved to ' + file);
+      return result.credential;
+    }
+    const states = [];
+    if (result?.browser_confirmed || result?.callback_confirmed) states.push('browser confirmed');
+    if (result?.dashboard_approved) states.push('dashboard approved');
+    console.log('Waiting for both confirmations' + (states.length ? ' (' + states.join(', ') + ')' : '') + '…');
+  }
+  throw new Error('Pairing timed out. No credential was saved.');
+}
+async function remote() {
+  if (Number(process.versions.node.split('.')[0]) < 20) throw new Error('Node.js 20 or newer is required.');
+  let base = DEFAULT_SERVER;
+  let credential;
+  const file = configPath();
+  try {
+    const config = JSON.parse(await fs.readFile(file, 'utf8'));
+    if (config.server_url) base = String(config.server_url).replace(/\/$/, '');
+    if (typeof config.device_credential === 'string' && config.device_credential.length >= 32) credential = config.device_credential;
+  } catch (e) { if (e.code !== 'ENOENT') throw new Error('Could not read ProjectBridge config: ' + e.message); }
+  const url = new URL(base);
+  if (url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost','127.0.0.1'].includes(url.hostname))) throw new Error('HTTPS is required except for localhost testing.');
+  if (!credential) credential = await enroll(base);
+  console.log('ProjectBridge remote presence mode started. Press Ctrl+C to stop.');
+  let delay = 30;
+  while (true) {
+    try {
+      const response = await request(base, '/api/commander/heartbeat', { metadata: hostInfo() }, credential);
+      if (!response.result?.device_id) throw new Error('Heartbeat response was incomplete.');
+      console.log(new Date().toISOString() + ' Connected (device ' + response.result.device_id + ').');
+      delay = 30;
+    } catch (e) {
+      console.error('Connection unavailable: ' + e.message + '. Retrying in ' + delay + 's.');
+      delay = Math.min(300, delay * 2);
+    }
+    await sleep(delay * 1000);
+  }
+}
+async function main() {
+  const command = process.argv[2];
+  if (command === 'remote') return remote();
+  if (command === '--help' || command === '-h' || command === 'help' || !command) {
+    console.log('ProjectBridge Remote ' + VERSION + '\n\nUsage: npx --yes @brrew/projectbridge@latest remote\n\nCommands:\n  remote   Enroll this host and keep its heartbeat online\n  help     Show this help\n\nThis first CLI release reports host presence only; remote command execution is not yet implemented.');
+    return;
+  }
+  throw new Error('Unknown command: ' + command + '. Run with --help.');
+}
+main().catch(e => { console.error('ProjectBridge: ' + e.message); process.exitCode = 1; });

package/package.json

@@ -1,6 +1,20 @@
 {
   "name": "@brrew/projectbridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "ProjectBridge remote host agent CLI",
+  "license": "UNLICENSED",
+  "type": "commonjs",
+  "bin": {
+    "projectbridge": "bin/projectbridge.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  }
+}