start-command 0.13.0 → 0.15.0

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

@@ -1,30 +0,0 @@
-#!/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

@@ -1,54 +0,0 @@
-#!/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

@@ -1,56 +0,0 @@
-#!/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/experiments/test-screen-attached.js

@@ -1,126 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Experiment to test different approaches for running screen in attached mode
- * from Bun without a TTY
- */
-
-const { spawn, spawnSync, execSync } = require('child_process');
-
-async function testApproaches() {
-  console.log('=== Testing Attached Mode Approaches ===\n');
-
-  // Approach 1: Using script command as wrapper
-  console.log('Approach 1: script -q -c "screen ..." /dev/null');
-  try {
-    const sessionName = `approach1-${Date.now()}`;
-    const result = spawnSync(
-      'script',
-      [
-        '-q',
-        '-c',
-        `screen -S ${sessionName} /bin/sh -c "echo hello; exit 0"`,
-        '/dev/null',
-      ],
-      {
-        stdio: ['inherit', 'pipe', 'pipe'],
-        timeout: 5000,
-      }
-    );
-    console.log(
-      `   stdout: "${result.stdout.toString().trim().replace(/\n/g, '\\n')}"`
-    );
-    console.log(
-      `   stderr: "${result.stderr.toString().trim().replace(/\n/g, '\\n')}"`
-    );
-    console.log(`   exit: ${result.status}`);
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`   Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Approach 2: Using detached mode + wait for completion + capture output via log
-  console.log('Approach 2: detached + log capture');
-  try {
-    const sessionName = `approach2-${Date.now()}`;
-    const logFile = `/tmp/screen-${sessionName}.log`;
-
-    // Start with logging
-    execSync(
-      `screen -dmS ${sessionName} -L -Logfile ${logFile} /bin/sh -c "echo 'hello from approach2'"`,
-      {
-        stdio: 'inherit',
-      }
-    );
-
-    // Wait for completion
-    await new Promise((r) => setTimeout(r, 500));
-
-    // Read log
-    const output = execSync(`cat ${logFile}`, { encoding: 'utf8' });
-    console.log(`   Output: "${output.trim()}"`);
-    console.log(`   Status: SUCCESS`);
-
-    // Cleanup
-    try {
-      execSync(`rm ${logFile} 2>/dev/null`);
-    } catch {}
-    try {
-      execSync(`screen -S ${sessionName} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`   Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Approach 3: Using stdio: 'inherit' with proper terminal allocation via script
-  console.log('Approach 3: Run through script, inherit all stdio');
-  try {
-    const sessionName = `approach3-${Date.now()}`;
-    const result = spawnSync(
-      'script',
-      [
-        '-q',
-        '-e',
-        '-c',
-        `screen -S ${sessionName} /bin/sh -c "echo hello_approach3"`,
-        '/dev/null',
-      ],
-      {
-        stdio: 'inherit',
-        timeout: 5000,
-      }
-    );
-    console.log(`   exit: ${result.status}`);
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`   Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Approach 4: Direct run without screen for attached mode (fallback)
-  console.log(
-    'Approach 4: Just spawn the shell command directly (fallback, no screen)'
-  );
-  try {
-    const result = spawnSync('/bin/sh', ['-c', 'echo hello_direct'], {
-      stdio: ['inherit', 'pipe', 'pipe'],
-      timeout: 5000,
-    });
-    console.log(`   stdout: "${result.stdout.toString().trim()}"`);
-    console.log(`   exit: ${result.status}`);
-  } catch (e) {
-    console.log(`   Error: ${e.message}`);
-  }
-  console.log('');
-
-  console.log('=== Approaches Tested ===');
-}
-
-testApproaches();

package/experiments/test-screen-logfile.js

@@ -1,286 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Experiment to test screen's logfile capture functionality
- * to understand the root cause of issue #15
- */
-
-const { execSync, spawnSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-async function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-async function testScreenLogfile() {
-  console.log('=== Testing Screen Logfile Capture ===\n');
-
-  // Test environment info
-  console.log('Environment:');
-  console.log(`  Platform: ${process.platform}`);
-  console.log(`  Node: ${process.version}`);
-  try {
-    const screenVersion = execSync('screen --version', {
-      encoding: 'utf8',
-    }).trim();
-    console.log(`  Screen: ${screenVersion}`);
-  } catch (e) {
-    console.log(`  Screen: Not available - ${e.message}`);
-    return;
-  }
-  console.log(
-    `  TTY: stdin=${process.stdin.isTTY}, stdout=${process.stdout.isTTY}`
-  );
-  console.log('');
-
-  // Test 1: Basic logfile capture with -L -Logfile
-  console.log('Test 1: Basic -L -Logfile capture');
-  const sessionName1 = `logtest-${Date.now()}`;
-  const logFile1 = path.join(os.tmpdir(), `screen-log-${sessionName1}.log`);
-
-  try {
-    // Run screen with logging
-    const screenArgs = [
-      '-dmS',
-      sessionName1,
-      '-L',
-      '-Logfile',
-      logFile1,
-      '/bin/sh',
-      '-c',
-      'echo "TESTOUTPUT123"',
-    ];
-
-    console.log(`  Command: screen ${screenArgs.join(' ')}`);
-
-    execSync(`screen ${screenArgs.map((a) => `"${a}"`).join(' ')}`, {
-      stdio: 'inherit',
-    });
-
-    // Wait for completion (screen runs command and exits)
-    await sleep(500);
-
-    // Check if session still exists
-    let sessionExists = false;
-    try {
-      const sessions = execSync('screen -ls', {
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-      sessionExists = sessions.includes(sessionName1);
-    } catch {
-      // screen -ls returns non-zero if no sessions
-    }
-    console.log(`  Session exists after 500ms: ${sessionExists}`);
-
-    // Check log file
-    if (fs.existsSync(logFile1)) {
-      const content = fs.readFileSync(logFile1, 'utf8');
-      console.log(`  Log file exists: YES`);
-      console.log(`  Log file size: ${content.length} bytes`);
-      console.log(
-        `  Log content: "${content.trim().replace(/\n/g, '\\n').slice(0, 200)}"`
-      );
-      console.log(
-        `  Contains expected output: ${content.includes('TESTOUTPUT123') ? 'YES ✓' : 'NO ✗'}`
-      );
-      fs.unlinkSync(logFile1);
-    } else {
-      console.log(`  Log file exists: NO ✗`);
-      console.log(`  Expected path: ${logFile1}`);
-    }
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName1} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`  Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Test 2: Test with sleep to ensure buffer flush
-  console.log('Test 2: With sleep for buffer flush');
-  const sessionName2 = `logtest2-${Date.now()}`;
-  const logFile2 = path.join(os.tmpdir(), `screen-log-${sessionName2}.log`);
-
-  try {
-    const screenArgs = [
-      '-dmS',
-      sessionName2,
-      '-L',
-      '-Logfile',
-      logFile2,
-      '/bin/sh',
-      '-c',
-      'echo "FLUSHED_OUTPUT" && sleep 0.5',
-    ];
-
-    console.log(`  Command: screen ${screenArgs.join(' ')}`);
-
-    execSync(`screen ${screenArgs.map((a) => `"${a}"`).join(' ')}`, {
-      stdio: 'inherit',
-    });
-
-    // Wait longer for flush (default is 10 seconds)
-    await sleep(1500);
-
-    // Check log file
-    if (fs.existsSync(logFile2)) {
-      const content = fs.readFileSync(logFile2, 'utf8');
-      console.log(`  Log file exists: YES`);
-      console.log(`  Log file size: ${content.length} bytes`);
-      console.log(
-        `  Contains expected output: ${content.includes('FLUSHED_OUTPUT') ? 'YES ✓' : 'NO ✗'}`
-      );
-      fs.unlinkSync(logFile2);
-    } else {
-      console.log(`  Log file exists: NO ✗`);
-    }
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName2} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`  Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Test 3: Alternative - using hardstatus/output redirection
-  console.log('Test 3: Direct command output capture (no screen logging)');
-  const sessionName3 = `logtest3-${Date.now()}`;
-  const logFile3 = path.join(os.tmpdir(), `screen-log-${sessionName3}.log`);
-
-  try {
-    // Run command through screen but capture output to file within the command
-    const command = `echo "DIRECT_CAPTURE" | tee ${logFile3}`;
-    const screenArgs = ['-dmS', sessionName3, '/bin/sh', '-c', command];
-
-    console.log(`  Command: screen ${screenArgs.join(' ')}`);
-
-    execSync(`screen ${screenArgs.map((a) => `"${a}"`).join(' ')}`, {
-      stdio: 'inherit',
-    });
-
-    await sleep(500);
-
-    // Check log file
-    if (fs.existsSync(logFile3)) {
-      const content = fs.readFileSync(logFile3, 'utf8');
-      console.log(`  Log file exists: YES`);
-      console.log(
-        `  Contains expected output: ${content.includes('DIRECT_CAPTURE') ? 'YES ✓' : 'NO ✗'}`
-      );
-      fs.unlinkSync(logFile3);
-    } else {
-      console.log(`  Log file exists: NO ✗`);
-    }
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName3} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`  Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Test 4: Script command approach
-  console.log('Test 4: Using script command to capture output');
-  const sessionName4 = `logtest4-${Date.now()}`;
-  const logFile4 = path.join(os.tmpdir(), `script-log-${sessionName4}.log`);
-
-  try {
-    // Use script to capture output
-    const result = spawnSync(
-      'script',
-      [
-        '-q',
-        logFile4,
-        '-c',
-        `screen -dmS ${sessionName4} /bin/sh -c "echo SCRIPT_CAPTURE"`,
-      ],
-      {
-        stdio: ['inherit', 'pipe', 'pipe'],
-        timeout: 5000,
-      }
-    );
-
-    await sleep(500);
-
-    console.log(`  Exit code: ${result.status}`);
-
-    // Check log file
-    if (fs.existsSync(logFile4)) {
-      const content = fs.readFileSync(logFile4, 'utf8');
-      console.log(`  Log file exists: YES`);
-      console.log(`  Log file size: ${content.length} bytes`);
-      fs.unlinkSync(logFile4);
-    } else {
-      console.log(`  Log file exists: NO`);
-    }
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName4} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`  Error: ${e.message}`);
-  }
-  console.log('');
-
-  // Test 5: Test with -T option (terminal type)
-  console.log('Test 5: With explicit terminal type -T xterm');
-  const sessionName5 = `logtest5-${Date.now()}`;
-  const logFile5 = path.join(os.tmpdir(), `screen-log-${sessionName5}.log`);
-
-  try {
-    const screenArgs = [
-      '-T',
-      'xterm',
-      '-dmS',
-      sessionName5,
-      '-L',
-      '-Logfile',
-      logFile5,
-      '/bin/sh',
-      '-c',
-      'echo "TERMINAL_OUTPUT" && sleep 0.3',
-    ];
-
-    console.log(`  Command: screen ${screenArgs.join(' ')}`);
-
-    execSync(`screen ${screenArgs.map((a) => `"${a}"`).join(' ')}`, {
-      stdio: 'inherit',
-    });
-
-    await sleep(1000);
-
-    // Check log file
-    if (fs.existsSync(logFile5)) {
-      const content = fs.readFileSync(logFile5, 'utf8');
-      console.log(`  Log file exists: YES`);
-      console.log(`  Log file size: ${content.length} bytes`);
-      console.log(
-        `  Contains expected output: ${content.includes('TERMINAL_OUTPUT') ? 'YES ✓' : 'NO ✗'}`
-      );
-      fs.unlinkSync(logFile5);
-    } else {
-      console.log(`  Log file exists: NO ✗`);
-    }
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName5} -X quit 2>/dev/null`);
-    } catch {}
-  } catch (e) {
-    console.log(`  Error: ${e.message}`);
-  }
-  console.log('');
-
-  console.log('=== Tests Complete ===');
-}
-
-testScreenLogfile();

package/experiments/test-screen-modes.js

@@ -1,128 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Experiment to test different screen invocation modes
- * This helps understand how screen behaves in different contexts
- */
-
-const { spawn, execSync, spawnSync } = require('child_process');
-
-async function testScreenModes() {
-  console.log('=== Testing Screen Modes ===\n');
-
-  // Test 1: Check if running in a terminal
-  console.log('1. Terminal check:');
-  console.log(`   process.stdin.isTTY: ${process.stdin.isTTY}`);
-  console.log(`   process.stdout.isTTY: ${process.stdout.isTTY}`);
-  console.log(`   TERM: ${process.env.TERM || 'not set'}`);
-  console.log('');
-
-  // Test 2: Detached mode should work
-  console.log('2. Testing detached mode (screen -dmS):');
-  try {
-    const sessionName = `test-${Date.now()}`;
-    execSync(
-      `screen -dmS ${sessionName} /bin/sh -c "echo hello > /tmp/screen-test-${sessionName}.txt"`,
-      {
-        stdio: 'inherit',
-      }
-    );
-    // Wait a bit for the command to complete
-    await new Promise((r) => setTimeout(r, 200));
-
-    const output = execSync(
-      `cat /tmp/screen-test-${sessionName}.txt 2>/dev/null || echo "file not found"`,
-      { encoding: 'utf8' }
-    );
-    console.log(`   Output: ${output.trim()}`);
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName} -X quit 2>/dev/null`);
-    } catch {}
-    try {
-      execSync(`rm /tmp/screen-test-${sessionName}.txt 2>/dev/null`);
-    } catch {}
-
-    console.log('   Status: SUCCESS');
-  } catch (e) {
-    console.log(`   Status: FAILED - ${e.message}`);
-  }
-  console.log('');
-
-  // Test 3: Attached mode with spawn (current implementation)
-  console.log('3. Testing attached mode with spawn (current implementation):');
-  try {
-    const sessionName = `test-${Date.now()}`;
-    const result = spawnSync(
-      'screen',
-      ['-S', sessionName, '/bin/sh', '-c', 'echo hello'],
-      {
-        stdio: 'inherit',
-      }
-    );
-    console.log(`   Exit code: ${result.status}`);
-    console.log(`   Status: ${result.status === 0 ? 'SUCCESS' : 'FAILED'}`);
-  } catch (e) {
-    console.log(`   Status: FAILED - ${e.message}`);
-  }
-  console.log('');
-
-  // Test 4: Try to use script command to allocate PTY
-  console.log('4. Testing with script command to allocate PTY:');
-  try {
-    const result = spawnSync(
-      'script',
-      ['-q', '-c', 'echo hello', '/dev/null'],
-      {
-        stdio: ['inherit', 'pipe', 'pipe'],
-      }
-    );
-    console.log(`   Output: ${result.stdout.toString().trim()}`);
-    console.log(`   Exit code: ${result.status}`);
-    console.log(`   Status: SUCCESS`);
-  } catch (e) {
-    console.log(`   Status: FAILED - ${e.message}`);
-  }
-  console.log('');
-
-  // Test 5: Detached mode with log capture
-  console.log('5. Testing detached mode with log capture:');
-  try {
-    const sessionName = `test-${Date.now()}`;
-    const logFile = `/tmp/screen-log-${sessionName}.txt`;
-
-    // Create detached session with logging
-    execSync(
-      `screen -dmS ${sessionName} -L -Logfile ${logFile} /bin/sh -c "echo 'hello from screen'; sleep 0.2"`,
-      {
-        stdio: 'inherit',
-      }
-    );
-
-    // Wait for command to complete
-    await new Promise((r) => setTimeout(r, 500));
-
-    const output = execSync(
-      `cat ${logFile} 2>/dev/null || echo "log not found"`,
-      { encoding: 'utf8' }
-    );
-    console.log(`   Log content: ${output.trim().replace(/\n/g, '\\n')}`);
-
-    // Cleanup
-    try {
-      execSync(`screen -S ${sessionName} -X quit 2>/dev/null`);
-    } catch {}
-    try {
-      execSync(`rm ${logFile} 2>/dev/null`);
-    } catch {}
-
-    console.log('   Status: SUCCESS');
-  } catch (e) {
-    console.log(`   Status: FAILED - ${e.message}`);
-  }
-  console.log('');
-
-  console.log('=== Tests Complete ===');
-}
-
-testScreenModes();