start-command 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # start-command
 
+## 0.6.0
+
+### Minor Changes
+
+- 37eb93b: Drop zellij isolation backend support, focusing on screen, tmux, and docker. Remove zellij from VALID_BACKENDS, remove runInZellij function, and update all documentation accordingly.
+
 ## 0.5.3
 
 ### Patch Changes

package/README.md

@@ -141,18 +141,17 @@ $ -i tmux -s my-session -d npm start
 | -------- | -------------------------------------- | ---------------------------------------------------------- |
 | `screen` | GNU Screen terminal multiplexer        | `apt install screen` / `brew install screen`               |
 | `tmux`   | Modern terminal multiplexer            | `apt install tmux` / `brew install tmux`                   |
-| `zellij` | Modern terminal workspace              | `cargo install zellij` / `brew install zellij`             |
 | `docker` | Container isolation (requires --image) | [Docker Installation](https://docs.docker.com/get-docker/) |
 
 #### Isolation Options
 
-| Option           | Description                                      |
-| ---------------- | ------------------------------------------------ |
-| `--isolated, -i` | Isolation backend (screen, tmux, docker, zellij) |
-| `--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)     |
+| Option           | Description                                  |
+| ---------------- | -------------------------------------------- |
+| `--isolated, -i` | Isolation backend (screen, tmux, docker)     |
+| `--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) |
 
 **Note:** Using both `--attached` and `--detached` together will result in an error - you must choose one mode.
 

package/REQUIREMENTS.md

@@ -147,7 +147,6 @@ Support two patterns for passing wrapper options:
 
 - `screen`: GNU Screen terminal multiplexer
 - `tmux`: tmux terminal multiplexer
-- `zellij`: Modern terminal workspace
 - `docker`: Docker containers (requires --image option)
 
 #### 6.4 Mode Behavior

package/experiments/isolation-design.md

@@ -10,11 +10,10 @@ This document outlines the design for adding process isolation support to start-
 
 1. **screen** - GNU Screen, classic session manager
 2. **tmux** - Modern terminal multiplexer
-3. **zellij** - Modern, user-friendly multiplexer
 
 ### Container Isolation
 
-4. **docker** - Docker containers
+3. **docker** - Docker containers
 
 ## Command Syntax
 
@@ -31,7 +30,7 @@ $ [wrapper-options] command [command-options]
 ### Wrapper Options
 
 - `--isolated <backend>` or `-i <backend>`: Run command in isolated environment
-  - Backends: `screen`, `tmux`, `docker`, `zellij`
+  - Backends: `screen`, `tmux`, `docker`
 - `--attached` or `-a`: Run in attached mode (foreground)
 - `--detached` or `-d`: Run in detached mode (background)
 - `--session <name>` or `-s <name>`: Name for the session (optional)
@@ -56,7 +55,7 @@ $ -i tmux -d npm start
 
 ### Attached Mode (--attached)
 
-- Default for terminal multiplexers (screen, tmux, zellij)
+- Default for terminal multiplexers (screen, tmux)
 - Command runs in foreground
 - User can interact with the terminal
 - For docker: runs with -it flags
@@ -103,16 +102,6 @@ tmux new-session -s <session> '<command>'
 tmux new-session -d -s <session> '<command>'
 ```
 
-#### Zellij
-
-```bash
-# Attached
-zellij run -- <command>
-
-# Detached (via layout file or action)
-zellij -s <session> action new-pane -- <command>
-```
-
 #### Docker
 
 ```bash

package/package.json

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

package/src/bin/cli.js

@@ -62,7 +62,7 @@ function printUsage() {
   console.log('');
   console.log('Options:');
   console.log(
-    '  --isolated, -i <environment>      Run in isolated environment (screen, tmux, docker, zellij)'
+    '  --isolated, -i <environment>      Run in isolated environment (screen, tmux, docker)'
   );
   console.log('  --attached, -a            Run in attached mode (foreground)');
   console.log('  --detached, -d            Run in detached mode (background)');
@@ -85,7 +85,7 @@ function printUsage() {
     '  - Auto-reports failures for NPM packages (when gh is available)'
   );
   console.log('  - Natural language command aliases (via substitutions.lino)');
-  console.log('  - Process isolation via screen, tmux, zellij, or docker');
+  console.log('  - Process isolation via screen, tmux, or docker');
   console.log('');
   console.log('Alias examples:');
   console.log('  $ install lodash npm package           -> npm install lodash');

package/src/lib/args-parser.js

@@ -6,7 +6,7 @@
  * 2. $ [wrapper-options] command [command-options]
  *
  * Wrapper Options:
- * --isolated, -i <backend>  Run in isolated environment (screen, tmux, docker, zellij)
+ * --isolated, -i <backend>  Run in isolated environment (screen, tmux, docker)
  * --attached, -a            Run in attached mode (foreground)
  * --detached, -d            Run in detached mode (background)
  * --session, -s <name>      Session name for isolation
@@ -20,7 +20,7 @@ const DEBUG =
 /**
  * Valid isolation backends
  */
-const VALID_BACKENDS = ['screen', 'tmux', 'docker', 'zellij'];
+const VALID_BACKENDS = ['screen', 'tmux', 'docker'];
 
 /**
  * Parse command line arguments into wrapper options and command
@@ -29,7 +29,7 @@ const VALID_BACKENDS = ['screen', 'tmux', 'docker', 'zellij'];
  */
 function parseArgs(args) {
   const wrapperOptions = {
-    isolated: null, // Isolation backend: screen, tmux, docker, zellij
+    isolated: null, // Isolation backend: screen, tmux, docker
     attached: false, // Run in attached mode
     detached: false, // Run in detached mode
     session: null, // Session name
@@ -116,7 +116,7 @@ function parseOption(args, index, options) {
       return 2;
     } else {
       throw new Error(
-        `Option ${arg} requires a backend argument (screen, tmux, docker, zellij)`
+        `Option ${arg} requires a backend argument (screen, tmux, docker)`
       );
     }
   }

package/src/lib/isolation.js

@@ -4,7 +4,6 @@
  * Provides execution of commands in various isolated environments:
  * - screen: GNU Screen terminal multiplexer
  * - tmux: tmux terminal multiplexer
- * - zellij: Modern terminal workspace
  * - docker: Docker containers
  */
 
@@ -462,87 +461,6 @@ function runInTmux(command, options = {}) {
   }
 }
 
-/**
- * Run command in Zellij
- * @param {string} command - Command to execute
- * @param {object} options - Options (session, detached)
- * @returns {Promise<{success: boolean, sessionName: string, message: string}>}
- */
-function runInZellij(command, options = {}) {
-  if (!isCommandAvailable('zellij')) {
-    return Promise.resolve({
-      success: false,
-      sessionName: null,
-      message:
-        'zellij is not installed. Install it with: cargo install zellij or brew install zellij (macOS)',
-    });
-  }
-
-  const sessionName = options.session || generateSessionName('zellij');
-  const { shell, shellArg } = getShell();
-
-  try {
-    if (options.detached) {
-      // Detached mode for zellij
-      if (DEBUG) {
-        console.log(`[DEBUG] Creating detached zellij session: ${sessionName}`);
-      }
-
-      // Create the session in background
-      execSync(
-        `zellij -s "${sessionName}" action new-tab -- ${shell} ${shellArg} "${command}" &`,
-        { stdio: 'inherit', shell: true }
-      );
-
-      return Promise.resolve({
-        success: true,
-        sessionName,
-        message: `Command started in detached zellij session: ${sessionName}\nReattach with: zellij attach ${sessionName}`,
-      });
-    } else {
-      // Attached mode: zellij -s <session> -- <shell> -c <command>
-      if (DEBUG) {
-        console.log(
-          `[DEBUG] Running: zellij -s "${sessionName}" -- ${shell} ${shellArg} "${command}"`
-        );
-      }
-
-      return new Promise((resolve) => {
-        const child = spawn(
-          'zellij',
-          ['-s', sessionName, '--', shell, shellArg, command],
-          {
-            stdio: 'inherit',
-          }
-        );
-
-        child.on('exit', (code) => {
-          resolve({
-            success: code === 0,
-            sessionName,
-            message: `Zellij session "${sessionName}" exited with code ${code}`,
-            exitCode: code,
-          });
-        });
-
-        child.on('error', (err) => {
-          resolve({
-            success: false,
-            sessionName,
-            message: `Failed to start zellij: ${err.message}`,
-          });
-        });
-      });
-    }
-  } catch (err) {
-    return Promise.resolve({
-      success: false,
-      sessionName,
-      message: `Failed to run in zellij: ${err.message}`,
-    });
-  }
-}
-
 /**
  * Run command in Docker container
  * @param {string} command - Command to execute
@@ -649,7 +567,7 @@ function runInDocker(command, options = {}) {
 
 /**
  * Run command in the specified isolation backend
- * @param {string} backend - Isolation backend (screen, tmux, docker, zellij)
+ * @param {string} backend - Isolation backend (screen, tmux, docker)
  * @param {string} command - Command to execute
  * @param {object} options - Options
  * @returns {Promise<{success: boolean, message: string}>}
@@ -660,8 +578,6 @@ function runIsolated(backend, command, options = {}) {
       return runInScreen(command, options);
     case 'tmux':
       return runInTmux(command, options);
-    case 'zellij':
-      return runInZellij(command, options);
     case 'docker':
       return runInDocker(command, options);
     default:
@@ -780,7 +696,6 @@ module.exports = {
   hasTTY,
   runInScreen,
   runInTmux,
-  runInZellij,
   runInDocker,
   runIsolated,
   // Export logging utilities for unified experience

package/test/args-parser.test.js

@@ -382,8 +382,4 @@ describe('VALID_BACKENDS', () => {
   it('should include docker', () => {
     assert.ok(VALID_BACKENDS.includes('docker'));
   });
-
-  it('should include zellij', () => {
-    assert.ok(VALID_BACKENDS.includes('zellij'));
-  });
 });

package/test/isolation.test.js

@@ -76,12 +76,6 @@ describe('Isolation Module', () => {
       console.log(`  docker available: ${result}`);
       assert.ok(typeof result === 'boolean');
     });
-
-    it('should check if zellij is available', () => {
-      const result = isCommandAvailable('zellij');
-      console.log(`  zellij available: ${result}`);
-      assert.ok(typeof result === 'boolean');
-    });
   });
 
   describe('getScreenVersion', () => {
@@ -178,7 +172,6 @@ describe('Isolation Runner Error Handling', () => {
     runInScreen,
     runInTmux,
     runInDocker,
-    runInZellij,
   } = require('../src/lib/isolation');
 
   describe('runInScreen', () => {
@@ -248,23 +241,6 @@ describe('Isolation Runner Error Handling', () => {
       );
     });
   });
-
-  describe('runInZellij', () => {
-    it('should return informative error if zellij is not installed', async () => {
-      // Skip if zellij is installed
-      if (isCommandAvailable('zellij')) {
-        console.log('  Skipping: zellij is installed');
-        return;
-      }
-
-      const result = await runInZellij('echo test', { detached: true });
-      assert.strictEqual(result.success, false);
-      assert.ok(result.message.includes('zellij is not installed'));
-      assert.ok(
-        result.message.includes('cargo') || result.message.includes('brew')
-      );
-    });
-  });
 });
 
 describe('Isolation Runner with Available Backends', () => {