dmux 3.1.1 → 3.3.0

package/dist/utils/shellPaneDetection.js

@@ -0,0 +1,179 @@
+/**
+ * Shell Pane Detection Utility
+ *
+ * Detects manually-created tmux panes and determines their shell type.
+ */
+import { LogService } from '../services/LogService.js';
+import { TmuxService } from '../services/TmuxService.js';
+/**
+ * Detects the shell type running in a tmux pane
+ * @param paneId The tmux pane ID (e.g., %1)
+ * @returns Shell type (bash, zsh, fish, etc) or 'shell' as fallback
+ */
+export async function detectShellType(paneId) {
+    const tmuxService = TmuxService.getInstance();
+    try {
+        // Get the command running in the pane
+        const { execSync } = await import('child_process');
+        const command = execSync(`tmux display-message -t '${paneId}' -p '#{pane_current_command}'`, { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        // Common shells
+        const knownShells = ['bash', 'zsh', 'fish', 'sh', 'ksh', 'tcsh', 'csh'];
+        // Check if it's a known shell
+        const lowerCommand = command.toLowerCase();
+        for (const shell of knownShells) {
+            if (lowerCommand === shell || lowerCommand.endsWith(`/${shell}`)) {
+                return shell;
+            }
+        }
+        // If running something else, still try to detect the parent shell
+        // This handles cases where a command is running in the shell
+        try {
+            const pid = execSync(`tmux display-message -t '${paneId}' -p '#{pane_pid}'`, { encoding: 'utf-8', stdio: 'pipe' }).trim();
+            // Get parent process
+            const ppid = execSync(`ps -o ppid= -p ${pid}`, {
+                encoding: 'utf-8',
+                stdio: 'pipe'
+            }).trim();
+            if (ppid) {
+                const parentCommand = execSync(`ps -o comm= -p ${ppid}`, {
+                    encoding: 'utf-8',
+                    stdio: 'pipe'
+                }).trim();
+                const lowerParent = parentCommand.toLowerCase();
+                for (const shell of knownShells) {
+                    if (lowerParent === shell || lowerParent.endsWith(`/${shell}`)) {
+                        return shell;
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors when trying to detect parent
+        }
+        // Fallback to generic 'shell'
+        return 'shell';
+    }
+    catch (error) {
+        LogService.getInstance().debug(`Failed to detect shell type for pane ${paneId}`, 'shellDetection');
+        return 'shell';
+    }
+}
+/**
+ * Gets all untracked tmux panes (panes not in dmux config)
+ * @param sessionName The tmux session name
+ * @param trackedPaneIds Array of pane IDs already tracked by dmux
+ * @param controlPaneId Optional control pane ID to exclude
+ * @param welcomePaneId Optional welcome pane ID to exclude
+ * @returns Array of untracked pane information
+ */
+export async function getUntrackedPanes(sessionName, trackedPaneIds, controlPaneId, welcomePaneId) {
+    try {
+        // Get all panes in the current session with ID, title, and current command
+        const { execSync } = await import('child_process');
+        const output = execSync(`tmux list-panes -s -F '#{pane_id}::#{pane_title}::#{pane_current_command}'`, { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        if (!output)
+            return [];
+        const untrackedPanes = [];
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const [paneId, title, command] = line.split('::');
+            if (!paneId || !paneId.startsWith('%'))
+                continue;
+            // CRITICAL: Skip internal dmux panes by title
+            if (title === 'dmux-spacer') {
+                LogService.getInstance().debug(`Excluding spacer pane: ${paneId}`, 'shellDetection');
+                continue;
+            }
+            if (title && title.startsWith('dmux v')) {
+                LogService.getInstance().debug(`Excluding control pane by title: ${paneId} (${title})`, 'shellDetection');
+                continue;
+            }
+            if (title === 'Welcome') {
+                LogService.getInstance().debug(`Excluding welcome pane: ${paneId}`, 'shellDetection');
+                continue;
+            }
+            // CRITICAL: Skip control and welcome panes by ID (most reliable method)
+            if (controlPaneId && paneId === controlPaneId) {
+                LogService.getInstance().debug(`Excluding control pane by ID: ${paneId}`, 'shellDetection');
+                continue;
+            }
+            if (welcomePaneId && paneId === welcomePaneId) {
+                LogService.getInstance().debug(`Excluding welcome pane by ID: ${paneId}`, 'shellDetection');
+                continue;
+            }
+            // CRITICAL: Skip panes running dmux itself (node process running dmux)
+            if (command && (command === 'node' || command.includes('dmux'))) {
+                LogService.getInstance().debug(`Excluding dmux process pane: ${paneId} (command: ${command})`, 'shellDetection');
+                continue;
+            }
+            // Skip already tracked panes
+            if (trackedPaneIds.includes(paneId))
+                continue;
+            LogService.getInstance().debug(`Found untracked pane: ${paneId} (title: ${title}, command: ${command})`, 'shellDetection');
+            untrackedPanes.push({ paneId, title: title || '', command: command || '' });
+        }
+        return untrackedPanes;
+    }
+    catch (error) {
+        LogService.getInstance().debug('Failed to get untracked panes', 'shellDetection');
+        return [];
+    }
+}
+/**
+ * Creates a DmuxPane object for a shell pane
+ * @param paneId The tmux pane ID
+ * @param nextId The next available dmux ID number
+ * @param existingTitle Optional existing title to preserve
+ * @returns DmuxPane object for the shell pane
+ */
+export async function createShellPane(paneId, nextId, existingTitle) {
+    const tmuxService = TmuxService.getInstance();
+    const shellType = await detectShellType(paneId);
+    // Use existing title if available and it's not a dmux internal title
+    // Otherwise generate shell-N naming
+    let slug;
+    if (existingTitle &&
+        existingTitle !== 'dmux-spacer' &&
+        !existingTitle.startsWith('dmux v') &&
+        existingTitle !== 'Welcome') {
+        slug = existingTitle;
+    }
+    else {
+        slug = `shell-${nextId}`;
+        // Only set the title if we're generating a new one
+        try {
+            await tmuxService.setPaneTitle(paneId, slug);
+        }
+        catch (error) {
+            LogService.getInstance().debug(`Failed to set title for shell pane ${paneId}`, 'shellDetection');
+        }
+    }
+    return {
+        id: `dmux-${nextId}`,
+        slug,
+        prompt: '', // No prompt for manually created panes
+        paneId,
+        type: 'shell',
+        shellType,
+    };
+}
+/**
+ * Gets the next available dmux ID number
+ * @param existingPanes Array of existing panes
+ * @returns Next available ID number
+ */
+export function getNextDmuxId(existingPanes) {
+    if (existingPanes.length === 0)
+        return 1;
+    // Extract numeric IDs from all panes
+    const ids = existingPanes
+        .map(p => {
+        const match = p.id.match(/^dmux-(\d+)$/);
+        return match ? parseInt(match[1], 10) : 0;
+    })
+        .filter(id => id > 0);
+    if (ids.length === 0)
+        return 1;
+    return Math.max(...ids) + 1;
+}
+//# sourceMappingURL=shellPaneDetection.js.map

package/dist/utils/shellPaneDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellPaneDetection.js","sourceRoot":"","sources":["../../src/utils/shellPaneDetection.ts"],"names":[],"mappings":"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"}

package/dist/utils/systemCheck.d.ts

@@ -0,0 +1,19 @@
+/**
+ * System requirement check results
+ */
+export interface ValidationResult {
+    canRun: boolean;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Validate all system requirements for dmux
+ * Returns validation result with errors and warnings
+ */
+export declare function validateSystemRequirements(): Promise<ValidationResult>;
+/**
+ * Print validation results to console with colors
+ * Exits process if critical errors found
+ */
+export declare function printValidationResults(result: ValidationResult): void;
+//# sourceMappingURL=systemCheck.d.ts.map

package/dist/utils/systemCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemCheck.d.ts","sourceRoot":"","sources":["../../src/utils/systemCheck.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAuHD;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA4B5E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAmBrE"}

package/dist/utils/systemCheck.js

@@ -0,0 +1,160 @@
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import { getAvailableAgents } from './agentDetection.js';
+import { LogService } from '../services/LogService.js';
+/**
+ * Check if tmux is installed and meets minimum version requirement
+ */
+function checkTmuxVersion(minVersion) {
+    try {
+        const version = execSync('tmux -V', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        // tmux -V outputs: "tmux 3.3a" or similar
+        const versionMatch = version.match(/tmux\s+([\d.]+)/);
+        if (!versionMatch) {
+            return {
+                valid: false,
+                errors: [`Could not parse tmux version: ${version}`]
+            };
+        }
+        const installedVersion = versionMatch[1];
+        const installed = parseVersion(installedVersion);
+        const required = parseVersion(minVersion);
+        if (compareVersions(installed, required) >= 0) {
+            return {
+                valid: true,
+                version: installedVersion,
+                errors: []
+            };
+        }
+        else {
+            return {
+                valid: false,
+                version: installedVersion,
+                errors: [`tmux version ${installedVersion} is below minimum required version ${minVersion}`]
+            };
+        }
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: ['tmux is not installed or not in PATH']
+        };
+    }
+}
+/**
+ * Check if git is installed and meets minimum version requirement
+ */
+function checkGitVersion(minVersion) {
+    try {
+        const version = execSync('git --version', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        // git --version outputs: "git version 2.39.0" or similar
+        const versionMatch = version.match(/git version\s+([\d.]+)/);
+        if (!versionMatch) {
+            return {
+                valid: false,
+                errors: [`Could not parse git version: ${version}`]
+            };
+        }
+        const installedVersion = versionMatch[1];
+        const installed = parseVersion(installedVersion);
+        const required = parseVersion(minVersion);
+        if (compareVersions(installed, required) >= 0) {
+            return {
+                valid: true,
+                version: installedVersion,
+                errors: []
+            };
+        }
+        else {
+            return {
+                valid: false,
+                version: installedVersion,
+                errors: [`git version ${installedVersion} is below minimum required version ${minVersion}`]
+            };
+        }
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: ['git is not installed or not in PATH']
+        };
+    }
+}
+/**
+ * Parse version string into comparable array [major, minor, patch]
+ */
+function parseVersion(version) {
+    return version.split('.').map(v => {
+        const num = parseInt(v.replace(/[^\d]/g, ''), 10);
+        return isNaN(num) ? 0 : num;
+    });
+}
+/**
+ * Compare two version arrays
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+function compareVersions(a, b) {
+    const maxLength = Math.max(a.length, b.length);
+    for (let i = 0; i < maxLength; i++) {
+        const aVal = a[i] || 0;
+        const bVal = b[i] || 0;
+        if (aVal < bVal)
+            return -1;
+        if (aVal > bVal)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Validate all system requirements for dmux
+ * Returns validation result with errors and warnings
+ */
+export async function validateSystemRequirements() {
+    const checks = {
+        tmux: checkTmuxVersion('3.0'),
+        git: checkGitVersion('2.20'),
+        agents: await getAvailableAgents()
+    };
+    const errors = [];
+    const warnings = [];
+    // Collect errors
+    errors.push(...checks.tmux.errors);
+    errors.push(...checks.git.errors);
+    // Warnings for missing agents
+    if (checks.agents.length === 0) {
+        warnings.push('No agents found (claude or opencode). You will not be able to use AI features.');
+    }
+    else if (checks.agents.length === 1) {
+        const allAgents = ['claude', 'opencode'];
+        const missing = allAgents.find(a => !checks.agents.includes(a));
+        warnings.push(`Agent '${missing}' not found. Only '${checks.agents[0]}' is available.`);
+    }
+    return {
+        canRun: checks.tmux.valid && checks.git.valid,
+        warnings,
+        errors
+    };
+}
+/**
+ * Print validation results to console with colors
+ * Exits process if critical errors found
+ */
+export function printValidationResults(result) {
+    const logger = LogService.getInstance();
+    if (result.errors.length > 0) {
+        console.error(chalk.red.bold('\n❌ System Requirements Check Failed:\n'));
+        result.errors.forEach(error => {
+            console.error(chalk.red(`  • ${error}`));
+            logger.error(error, 'systemCheck');
+        });
+        console.error(chalk.yellow('\nPlease install missing dependencies and try again.\n'));
+        process.exit(1);
+    }
+    if (result.warnings.length > 0) {
+        // Log warnings using logger instead of console.warn
+        result.warnings.forEach(warning => {
+            logger.warn(warning, 'systemCheck');
+        });
+    }
+}
+//# sourceMappingURL=systemCheck.js.map

package/dist/utils/systemCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemCheck.js","sourceRoot":"","sources":["../../src/utils/systemCheck.ts"],"names":[],"mappings":"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"}

package/dist/utils/tmux.d.ts

@@ -1,4 +1,75 @@
 import type { PanePosition } from '../types.js';
+export declare const SIDEBAR_WIDTH = 40;
+export declare const MIN_COMFORTABLE_WIDTH = 60;
+export declare const MAX_COMFORTABLE_WIDTH = 100;
+export declare const MIN_COMFORTABLE_HEIGHT = 15;
+export type { WindowDimensions } from '../types.js';
+/**
+ * Gets current window dimensions
+ * @deprecated Use TmuxService.getInstance().getWindowDimensionsSync() instead
+ */
+export declare const getWindowDimensions: () => import("./tmux.js").WindowDimensions;
+/**
+ * Gets current terminal (client) dimensions
+ * This is the actual terminal size, not the tmux window size
+ * @deprecated Use TmuxService.getInstance().getTerminalDimensionsSync() instead
+ */
+export declare const getTerminalDimensions: () => import("./tmux.js").WindowDimensions;
+/**
+ * Get pane positions for all panes
+ * @deprecated Use TmuxService.getInstance().getPanePositionsSync() instead
+ */
 export declare const getPanePositions: () => PanePosition[];
-export declare const applySmartLayout: (paneCount: number) => void;
+/**
+ * Creates a new tmux pane by splitting horizontally
+ * @param options - Split pane options
+ * @param options.targetPane - Pane to split from (optional)
+ * @param options.cwd - Working directory for new pane (optional)
+ * @param options.command - Command to run in new pane (optional)
+ * @returns The new pane ID
+ * @deprecated Use TmuxService.getInstance().splitPaneSync() instead
+ */
+export declare const splitPane: (options?: {
+    targetPane?: string;
+    cwd?: string;
+    command?: string;
+}) => string;
+/**
+ * Gets all pane IDs in current window
+ * @deprecated Use TmuxService.getInstance().getAllPaneIdsSync() instead
+ */
+export declare const getAllPaneIds: () => string[];
+/**
+ * Gets content pane IDs (excludes control pane and spacer pane)
+ * This uses synchronous operations to maintain compatibility with existing code
+ */
+export declare const getContentPaneIds: (controlPaneId: string) => string[];
+/**
+ * Creates initial sidebar layout by splitting from control pane
+ * @param controlPaneId The pane ID running dmux TUI (left sidebar)
+ * @returns The newly created content area pane ID
+ */
+export declare const setupSidebarLayout: (controlPaneId: string) => string;
+/**
+ * Generates a custom tmux layout string for [Sidebar | Grid] arrangement
+ * Format: checksum,WxH,X,Y{child1,child2,...}
+ * Each child: WxH,X,Y[pane_id] for leaf or WxH,X,Y{...} for container
+ */
+export declare const generateSidebarGridLayout: (controlPaneId: string, contentPanes: string[], sidebarWidth: number, windowWidth: number, windowHeight: number, columns: number, maxComfortableWidth?: number) => string;
+/**
+ * Calculates optimal number of columns for pane layout based on dimensions
+ * @param numPanes Number of panes to arrange
+ * @param contentWidth Available width for content panes
+ * @param contentHeight Available height for content panes
+ * @returns Optimal number of columns
+ */
+export declare const calculateOptimalColumns: (numPanes: number, contentWidth: number, contentHeight: number) => number;
+/**
+ * Enforces left sidebar layout: 40-char wide sidebar on left, content panes in grid on right
+ * This maintains the structure: [Sidebar (40 chars, full height) | Content Grid Area]
+ *
+ * @deprecated This function now delegates to the centralized layout manager.
+ * Consider using recalculateAndApplyLayout() directly from layoutManager.ts
+ */
+export declare const enforceControlPaneSize: (controlPaneId: string, width: number) => Promise<void>;
 //# sourceMappingURL=tmux.d.ts.map

package/dist/utils/tmux.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../src/utils/tmux.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,gBAAgB,QAAO,YAAY,EAoB/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,SAmBjD,CAAC"}
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../src/utils/tmux.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAoBzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAE/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,4CAEjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,YAAY,EAE/C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,UAAS;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,KAAG,MAER,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,MAAM,EAEtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,eAAe,MAAM,KAAG,MAAM,EAe/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAe,MAAM,KAAG,MAsC1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,eAAe,MAAM,EACrB,cAAc,MAAM,EAAE,EACtB,cAAc,MAAM,EACpB,aAAa,MAAM,EACnB,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,sBAAqB,MAA8B,KAClD,MA0LF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,eAAe,MAAM,KACpB,MA+CF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,eAAe,MAAM,EACrB,OAAO,MAAM,KACZ,OAAO,CAAC,IAAI,CA+Dd,CAAC"}