start-command 0.10.0 → 0.13.0

package/.github/workflows/release.yml

@@ -122,6 +122,58 @@ jobs:
       - name: Run tests
         run: bun test
 
+      # Test both execution modes (default and command-stream)
+      - name: Test default execution mode
+        run: |
+          bun run src/bin/cli.js echo "Testing default mode"
+          echo "Default mode test passed"
+
+      - name: Test command-stream execution mode
+        run: |
+          bun run src/bin/cli.js --use-command-stream echo "Testing command-stream mode"
+          echo "Command-stream mode test passed"
+
+      - name: Test command-stream via env variable
+        env:
+          START_USE_COMMAND_STREAM: '1'
+        run: |
+          bun run src/bin/cli.js echo "Testing env var mode"
+          echo "Env var mode test passed"
+
+      # SSH Integration Tests - Linux only (most reliable for SSH testing)
+      - name: Setup SSH server for integration tests (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          # Install openssh-server if not present
+          sudo apt-get install -y openssh-server
+
+          # Start SSH service
+          sudo systemctl start ssh
+
+          # Generate SSH key without passphrase for testing
+          ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N "" -C "ci-test-key"
+
+          # Add the public key to authorized_keys for passwordless login
+          cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys
+          chmod 600 ~/.ssh/authorized_keys
+
+          # Configure SSH to accept localhost connections without prompts
+          mkdir -p ~/.ssh
+          cat >> ~/.ssh/config << 'EOF'
+          Host localhost
+            StrictHostKeyChecking no
+            UserKnownHostsFile /dev/null
+            LogLevel ERROR
+          EOF
+          chmod 600 ~/.ssh/config
+
+          # Test SSH connectivity
+          ssh localhost "echo 'SSH connection successful'"
+
+      - name: Run SSH integration tests (Linux)
+        if: runner.os == 'Linux'
+        run: bun test test/ssh-integration.test.js
+
   # Release - only runs on main after tests pass (for push events)
   release:
     name: Release

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # start-command
 
+## 0.13.0
+
+### Minor Changes
+
+- 7763ae1: Use command-stream library for command execution in CLI
+
+  This update integrates the command-stream library to handle command execution, replacing direct usage of execSync and spawnSync in the main CLI flow. The change provides a more consistent API for running shell commands and better output handling.
+
+  Key changes:
+  - Added command-stream as a dependency
+  - Created a wrapper module for async command execution utilities
+  - Refactored printVersion(), runDirect(), and detectRepository() to use command-stream
+  - Converted main CLI flow to async for proper integration
+
+## 0.11.0
+
+### Minor Changes
+
+- 1240a29: Add SSH isolation support for remote command execution.
+  - Implements SSH backend for executing commands on remote servers via SSH, similar to screen/tmux/docker isolation
+  - Uses `--endpoint` option to specify SSH target (e.g., `--endpoint user@remote.server`)
+  - Supports both attached (interactive) and detached (background) modes
+  - Includes comprehensive SSH integration tests in CI with a local SSH server
+
 ## 0.10.0
 
 ### Minor Changes

package/README.md

@@ -136,7 +136,7 @@ Issue created: https://github.com/owner/some-npm-tool/issues/42
 
 ### Process Isolation
 
-Run commands in isolated environments using terminal multiplexers or containers:
+Run commands in isolated environments using terminal multiplexers, containers, or remote servers:
 
 ```bash
 # Run in tmux (attached by default)
@@ -148,6 +148,9 @@ $ --isolated screen --detached -- bun start
 # Run in docker container
 $ --isolated docker --image oven/bun:latest -- bun install
 
+# Run on remote server via SSH
+$ --isolated ssh --endpoint user@remote.server -- npm test
+
 # Short form with custom session name
 $ -i tmux -s my-session -d bun start
 ```
@@ -192,21 +195,23 @@ This is useful for:
 
 #### Supported Backends
 
-| Backend  | Description                            | Installation                                               |
-| -------- | -------------------------------------- | ---------------------------------------------------------- |
-| `screen` | GNU Screen terminal multiplexer        | `apt install screen` / `brew install screen`               |
-| `tmux`   | Modern terminal multiplexer            | `apt install tmux` / `brew install tmux`                   |
-| `docker` | Container isolation (requires --image) | [Docker Installation](https://docs.docker.com/get-docker/) |
+| Backend  | Description                                    | Installation                                               |
+| -------- | ---------------------------------------------- | ---------------------------------------------------------- |
+| `screen` | GNU Screen terminal multiplexer                | `apt install screen` / `brew install screen`               |
+| `tmux`   | Modern terminal multiplexer                    | `apt install tmux` / `brew install tmux`                   |
+| `docker` | Container isolation (requires --image)         | [Docker Installation](https://docs.docker.com/get-docker/) |
+| `ssh`    | Remote execution via SSH (requires --endpoint) | `apt install openssh-client` / `brew install openssh`      |
 
 #### Isolation Options
 
 | Option                           | Description                                               |
 | -------------------------------- | --------------------------------------------------------- |
-| `--isolated, -i`                 | Isolation backend (screen, tmux, docker)                  |
+| `--isolated, -i`                 | Isolation backend (screen, tmux, docker, ssh)             |
 | `--attached, -a`                 | Run in attached/foreground mode (default)                 |
 | `--detached, -d`                 | Run in detached/background mode                           |
 | `--session, -s`                  | Custom session/container name                             |
 | `--image`                        | Docker image (required for docker isolation)              |
+| `--endpoint`                     | SSH endpoint (required for ssh, e.g., user@host)          |
 | `--isolated-user, -u [name]`     | Create isolated user with same permissions (screen/tmux)  |
 | `--keep-user`                    | Keep isolated user after command completes (don't delete) |
 | `--keep-alive, -k`               | Keep session alive after command completes                |

package/bun.lock

@@ -4,6 +4,9 @@
   "workspaces": {
     "": {
       "name": "start-command",
+      "dependencies": {
+        "command-stream": "^0.8.3",
+      },
       "devDependencies": {
         "@changesets/cli": "^2.29.7",
         "eslint": "^9.38.0",
@@ -142,6 +145,8 @@
 
     "colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="],
 
+    "command-stream": ["command-stream@0.8.3", "", {}, "sha512-vwNf5AWLhD4awaYSIyjHEu7JrAMTu8BaJg1LIpE4HqTXFYtgzSTN/j1VnwHDTNz8sAG7zvZgtKYm9lmi4+0Z7Q=="],
+
     "commander": ["commander@14.0.2", "", {}, "sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ=="],
 
     "concat-map": ["concat-map@0.0.1", "", {}, "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="],

package/experiments/test-command-stream-cjs.cjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env bun
+/* global console */
+/**
+ * Experiment: Test command-stream with CommonJS require
+ */
+
+(async () => {
+  console.log(
+    '=== Testing command-stream with dynamic import in CommonJS ===\n'
+  );
+
+  // Need to use dynamic import since command-stream is ESM
+  const { $ } = await import('command-stream');
+
+  // Test 1: Basic sync command
+  console.log('Test 1: Basic sync command');
+  const result1 = $`echo "Hello from CJS"`.sync();
+  console.log('stdout:', result1.stdout);
+  console.log('exit code:', result1.code);
+  console.log('');
+
+  // Test 2: which command
+  console.log('Test 2: which command');
+  const result2 = $`which echo`.sync();
+  console.log('stdout:', result2.stdout.trim());
+  console.log('exit code:', result2.code);
+  console.log('');
+
+  console.log('=== All tests completed ===');
+})();

package/experiments/test-command-stream-wrapper.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env bun
+/**
+ * Experiment: Test command-stream wrapper module
+ */
+
+const {
+  execCommand,
+  execCommandAsync,
+  commandExists,
+  getCommandPath,
+  getToolVersion,
+} = require('../src/lib/command-stream');
+
+(async () => {
+  console.log('=== Testing command-stream wrapper ===\n');
+
+  // Test 1: Basic sync command
+  console.log('Test 1: execCommand (sync-like via promise)');
+  const result1 = await execCommand('echo "Hello from wrapper"');
+  console.log('stdout:', result1.stdout);
+  console.log('code:', result1.code);
+  console.log('');
+
+  // Test 2: Check if command exists
+  console.log('Test 2: commandExists');
+  const hasScreen = await commandExists('screen');
+  const hasFakeCmd = await commandExists('nonexistent-command-xyz');
+  console.log('screen exists:', hasScreen);
+  console.log('nonexistent-command-xyz exists:', hasFakeCmd);
+  console.log('');
+
+  // Test 3: Get command path
+  console.log('Test 3: getCommandPath');
+  const echoPath = await getCommandPath('echo');
+  console.log('echo path:', echoPath);
+  console.log('');
+
+  // Test 4: Get tool version
+  console.log('Test 4: getToolVersion');
+  const screenVersion = await getToolVersion('screen', '-v', true);
+  console.log('screen version:', screenVersion);
+  const tmuxVersion = await getToolVersion('tmux', '-V', true);
+  console.log('tmux version:', tmuxVersion);
+  console.log('');
+
+  // Test 5: Async command
+  console.log('Test 5: execCommandAsync');
+  const result5 = await execCommandAsync('uname -r');
+  console.log('stdout:', result5.stdout);
+  console.log('code:', result5.code);
+  console.log('');
+
+  console.log('=== All tests completed ===');
+})();

package/experiments/test-command-stream.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env bun
+/**
+ * Experiment: Test command-stream basic usage
+ */
+
+import { $ } from 'command-stream';
+
+console.log('=== Testing command-stream ===\n');
+
+// Test 1: Basic async command
+console.log('Test 1: Basic async command');
+const result1 = await $`echo "Hello from command-stream"`;
+console.log('stdout:', result1.stdout);
+console.log('exit code:', result1.code);
+console.log('');
+
+// Test 2: Sync command
+console.log('Test 2: Sync command');
+const result2 = $`echo "Sync hello"`.sync();
+console.log('stdout:', result2.stdout);
+console.log('exit code:', result2.code);
+console.log('');
+
+// Test 3: Command that uses system tools
+console.log('Test 3: which command');
+try {
+  const result3 = $`which echo`.sync();
+  console.log('stdout:', result3.stdout);
+  console.log('exit code:', result3.code);
+} catch (e) {
+  console.log('Error:', e.message);
+}
+console.log('');
+
+// Test 4: Get OS version on Linux
+console.log('Test 4: uname command');
+const result4 = $`uname -r`.sync();
+console.log('stdout:', result4.stdout.trim());
+console.log('exit code:', result4.code);
+console.log('');
+
+// Test 5: Silent mode (no mirror)
+console.log('Test 5: Silent mode with $({ mirror: false })');
+const $silent = $({ mirror: false, capture: true });
+const result5 = await $silent`echo "This should be silent"`;
+console.log('stdout:', result5.stdout);
+console.log('');
+
+// Test 6: Check if command exists
+console.log('Test 6: Check if screen exists');
+const result6 = $`which screen`.sync();
+console.log('screen exists:', result6.code === 0);
+console.log('screen path:', result6.stdout.trim());
+console.log('');
+
+console.log('=== All tests completed ===');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "start-command",
-  "version": "0.10.0",
+  "version": "0.13.0",
   "description": "Gamification of coding, execute any command with ability to auto-report issues on GitHub",
   "main": "index.js",
   "bin": {
@@ -59,5 +59,8 @@
       "prettier --write",
       "prettier --check"
     ]
+  },
+  "dependencies": {
+    "command-stream": "^0.8.3"
   }
 }