start-command 0.3.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # start-command
 
+## 0.5.1
+
+### Patch Changes
+
+- Test patch release
+
+## 0.5.0
+
+### Minor Changes
+
+- 95d8760: Unify output experience for isolation mode
+  - Change terminology from "Backend" to "Environment" in isolation output
+  - Add unified logging with timestamps for isolation modes (screen, tmux, docker, zellij)
+  - Save log files for all execution modes with consistent format
+  - Display start/end timestamps, exit code, and log file path uniformly across all modes
+
+## 0.4.1
+
+### Patch Changes
+
+- 73635f9: Make it bun first - update shebangs and installation docs
+
+## 0.4.0
+
+### Minor Changes
+
+- e8bec3c: Add process isolation support with --isolated option
+
+  This release adds the ability to run commands in isolated environments:
+
+  **New Features:**
+  - `--isolated` / `-i` option to run commands in screen, tmux, zellij, or docker
+  - `--attached` / `-a` and `--detached` / `-d` modes for foreground/background execution
+  - `--session` / `-s` option for custom session names
+  - `--image` option for Docker container image specification
+  - Two command syntax patterns: `$ [options] -- [command]` or `$ [options] command`
+
+  **Supported Backends:**
+  - GNU Screen - classic terminal multiplexer
+  - tmux - modern terminal multiplexer
+  - zellij - modern terminal workspace
+  - Docker - container isolation
+
+  **Examples:**
+
+  ```bash
+  $ --isolated tmux -- npm start
+  $ -i screen -d npm start
+  $ --isolated docker --image node:20 -- npm install
+  ```
+
 ## 0.3.1
 
 ### Patch Changes

package/README.md

@@ -4,6 +4,14 @@ Gamification of coding - execute any command with automatic logging and ability
 
 ## Installation
 
+We recommend using [Bun](https://bun.sh) for the best performance:
+
+```bash
+bun install -g start-command
+```
+
+Or using npm:
+
 ```bash
 npm install -g start-command
 ```

package/experiments/debug-regex.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Debug script to understand regex generation
  */

package/experiments/test-screen-output.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# Experiment to understand screen output behavior
+
+echo "=== Test 1: Direct screen with command ==="
+screen -S test1 /bin/sh -c 'echo "hello from test1"'
+
+echo ""
+echo "=== Test 2: Screen with -L logging ==="
+cd /tmp
+screen -L -Logfile screen-test.log -S test2 /bin/sh -c 'echo "hello from test2"'
+echo "Log contents:"
+cat /tmp/screen-test.log 2>/dev/null || echo "No log file created"
+
+echo ""
+echo "=== Test 3: Screen detached then capture ==="
+screen -dmS test3 /bin/sh -c 'echo "hello from test3" > /tmp/screen-test3-out.txt'
+sleep 0.5
+echo "Output from test3:"
+cat /tmp/screen-test3-out.txt 2>/dev/null || echo "No output file"
+
+echo ""
+echo "=== Test 4: Screen with wrap using script command ==="
+script -q /dev/null -c 'screen -S test4 /bin/sh -c "echo hello from test4"' 2>/dev/null || echo "Script method failed"
+
+echo ""
+echo "Cleanup"
+rm -f /tmp/screen-test.log /tmp/screen-test3-out.txt

package/experiments/test-substitution.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Test script for the substitution engine
  * Tests pattern matching with various inputs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "start-command",
-  "version": "0.3.1",
+  "version": "0.5.1",
   "description": "Gamification of coding, execute any command with ability to auto-report issues on GitHub",
   "main": "index.js",
   "bin": {

package/scripts/changeset-version.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Custom changeset version script that ensures package-lock.json is synchronized

package/scripts/check-file-size.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Check for files exceeding the maximum allowed line count

package/scripts/create-github-release.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Create GitHub Release from CHANGELOG.md

package/scripts/create-manual-changeset.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Create a changeset file for manual releases

package/scripts/format-github-release.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Format GitHub release notes using the format-release-notes.mjs script

package/scripts/format-release-notes.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Script to format GitHub release notes with proper formatting:

package/scripts/instant-version-bump.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Instant version bump script for manual releases

package/scripts/publish-to-npm.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Publish to npm using OIDC trusted publishing

package/scripts/setup-npm.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Update npm for OIDC trusted publishing

package/scripts/validate-changeset.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Validate changeset for CI - ensures exactly one valid changeset exists

package/scripts/version-and-commit.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 /**
  * Version packages and commit to main

package/src/bin/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 
 const { spawn, execSync } = require('child_process');
 const process = require('process');
@@ -13,7 +13,14 @@ const {
   hasIsolation,
   getEffectiveMode,
 } = require('../lib/args-parser');
-const { runIsolated } = require('../lib/isolation');
+const {
+  runIsolated,
+  getTimestamp,
+  createLogHeader,
+  createLogFooter,
+  writeLogFile,
+  createLogPath,
+} = require('../lib/isolation');
 
 // Configuration from environment variables
 const config = {
@@ -55,7 +62,7 @@ function printUsage() {
   console.log('');
   console.log('Options:');
   console.log(
-    '  --isolated, -i <backend>  Run in isolated environment (screen, tmux, docker, zellij)'
+    '  --isolated, -i <environment>      Run in isolated environment (screen, tmux, docker, zellij)'
   );
   console.log('  --attached, -a            Run in attached mode (foreground)');
   console.log('  --detached, -d            Run in detached mode (background)');
@@ -143,36 +150,70 @@ if (!config.disableSubstitutions) {
  * @param {string} cmd - Command to execute
  */
 async function runWithIsolation(options, cmd) {
-  const backend = options.isolated;
+  const environment = options.isolated;
   const mode = getEffectiveMode(options);
+  const startTime = getTimestamp();
+
+  // Create log file path
+  const logFilePath = createLogPath(environment);
+
+  // Get session name (will be generated by runIsolated if not provided)
+  const sessionName =
+    options.session ||
+    `${environment}-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+
+  // Print start message (unified format)
+  console.log(`[${startTime}] Starting: ${cmd}`);
+  console.log('');
 
   // Log isolation info
-  console.log(`[Isolation] Backend: ${backend}, Mode: ${mode}`);
+  console.log(`[Isolation] Environment: ${environment}, Mode: ${mode}`);
   if (options.session) {
     console.log(`[Isolation] Session: ${options.session}`);
   }
   if (options.image) {
     console.log(`[Isolation] Image: ${options.image}`);
   }
-  console.log(`[Isolation] Command: ${cmd}`);
   console.log('');
 
+  // Create log content
+  let logContent = createLogHeader({
+    command: cmd,
+    environment,
+    mode,
+    sessionName,
+    image: options.image,
+    startTime,
+  });
+
   // Run in isolation
-  const result = await runIsolated(backend, cmd, {
+  const result = await runIsolated(environment, cmd, {
     session: options.session,
     image: options.image,
     detached: mode === 'detached',
   });
 
-  // Print result
+  // Get exit code
+  const exitCode =
+    result.exitCode !== undefined ? result.exitCode : result.success ? 0 : 1;
+  const endTime = getTimestamp();
+
+  // Add result to log content
+  logContent += `${result.message}\n`;
+  logContent += createLogFooter(endTime, exitCode);
+
+  // Write log file
+  writeLogFile(logFilePath, logContent);
+
+  // Print result and footer (unified format)
   console.log('');
   console.log(result.message);
+  console.log('');
+  console.log(`[${endTime}] Finished`);
+  console.log(`Exit code: ${exitCode}`);
+  console.log(`Log saved: ${logFilePath}`);
 
-  if (result.success) {
-    process.exit(result.exitCode || 0);
-  } else {
-    process.exit(1);
-  }
+  process.exit(exitCode);
 }
 
 /**
@@ -301,12 +342,10 @@ function runDirect(cmd) {
   });
 }
 
-// Generate timestamp for logging
-function getTimestamp() {
-  return new Date().toISOString().replace('T', ' ').replace('Z', '');
-}
-
-// Generate unique log filename
+/**
+ * Generate unique log filename for direct execution
+ * @returns {string} Log filename
+ */
 function generateLogFilename() {
   const timestamp = Date.now();
   const random = Math.random().toString(36).substring(2, 8);

package/src/lib/isolation.js

@@ -9,6 +9,9 @@
  */
 
 const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
 const { generateSessionName } = require('./args-parser');
 
 // Debug mode from environment
@@ -409,6 +412,101 @@ function runIsolated(backend, command, options = {}) {
   }
 }
 
+/**
+ * Generate timestamp for logging
+ * @returns {string} ISO timestamp without 'T' and 'Z'
+ */
+function getTimestamp() {
+  return new Date().toISOString().replace('T', ' ').replace('Z', '');
+}
+
+/**
+ * Generate unique log filename
+ * @param {string} environment - The isolation environment name
+ * @returns {string} Log filename
+ */
+function generateLogFilename(environment) {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).substring(2, 8);
+  return `start-command-${environment}-${timestamp}-${random}.log`;
+}
+
+/**
+ * Create log content header
+ * @param {object} params - Log parameters
+ * @param {string} params.command - The command being executed
+ * @param {string} params.environment - The isolation environment
+ * @param {string} params.mode - attached or detached
+ * @param {string} params.sessionName - Session/container name
+ * @param {string} [params.image] - Docker image (for docker environment)
+ * @param {string} params.startTime - Start timestamp
+ * @returns {string} Log header content
+ */
+function createLogHeader(params) {
+  let content = `=== Start Command Log ===\n`;
+  content += `Timestamp: ${params.startTime}\n`;
+  content += `Command: ${params.command}\n`;
+  content += `Environment: ${params.environment}\n`;
+  content += `Mode: ${params.mode}\n`;
+  content += `Session: ${params.sessionName}\n`;
+  if (params.image) {
+    content += `Image: ${params.image}\n`;
+  }
+  content += `Platform: ${process.platform}\n`;
+  content += `Node Version: ${process.version}\n`;
+  content += `Working Directory: ${process.cwd()}\n`;
+  content += `${'='.repeat(50)}\n\n`;
+  return content;
+}
+
+/**
+ * Create log content footer
+ * @param {string} endTime - End timestamp
+ * @param {number} exitCode - Exit code
+ * @returns {string} Log footer content
+ */
+function createLogFooter(endTime, exitCode) {
+  let content = `\n${'='.repeat(50)}\n`;
+  content += `Finished: ${endTime}\n`;
+  content += `Exit Code: ${exitCode}\n`;
+  return content;
+}
+
+/**
+ * Write log file
+ * @param {string} logPath - Path to log file
+ * @param {string} content - Log content
+ * @returns {boolean} Success status
+ */
+function writeLogFile(logPath, content) {
+  try {
+    fs.writeFileSync(logPath, content, 'utf8');
+    return true;
+  } catch (err) {
+    console.error(`\nWarning: Could not save log file: ${err.message}`);
+    return false;
+  }
+}
+
+/**
+ * Get log directory from environment or use system temp
+ * @returns {string} Log directory path
+ */
+function getLogDir() {
+  return process.env.START_LOG_DIR || os.tmpdir();
+}
+
+/**
+ * Create log file path
+ * @param {string} environment - The isolation environment
+ * @returns {string} Full path to log file
+ */
+function createLogPath(environment) {
+  const logDir = getLogDir();
+  const logFilename = generateLogFilename(environment);
+  return path.join(logDir, logFilename);
+}
+
 module.exports = {
   isCommandAvailable,
   runInScreen,
@@ -416,4 +514,12 @@ module.exports = {
   runInZellij,
   runInDocker,
   runIsolated,
+  // Export logging utilities for unified experience
+  getTimestamp,
+  generateLogFilename,
+  createLogHeader,
+  createLogFooter,
+  writeLogFile,
+  getLogDir,
+  createLogPath,
 };

package/test/args-parser.test.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Unit tests for the argument parser
  * Tests wrapper options parsing, validation, and command extraction

package/test/isolation.test.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Unit tests for the isolation module
  * Tests command availability checking and session name generation

package/test/substitution.test.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 /**
  * Unit tests for the substitution engine
  * Tests pattern matching, variable substitution, and rule precedence

package/.changeset/isolation-support.md

@@ -1,30 +0,0 @@
----
-'start-command': minor
----
-
-Add process isolation support with --isolated option
-
-This release adds the ability to run commands in isolated environments:
-
-**New Features:**
-
-- `--isolated` / `-i` option to run commands in screen, tmux, zellij, or docker
-- `--attached` / `-a` and `--detached` / `-d` modes for foreground/background execution
-- `--session` / `-s` option for custom session names
-- `--image` option for Docker container image specification
-- Two command syntax patterns: `$ [options] -- [command]` or `$ [options] command`
-
-**Supported Backends:**
-
-- GNU Screen - classic terminal multiplexer
-- tmux - modern terminal multiplexer
-- zellij - modern terminal workspace
-- Docker - container isolation
-
-**Examples:**
-
-```bash
-$ --isolated tmux -- npm start
-$ -i screen -d npm start
-$ --isolated docker --image node:20 -- npm install
-```