@ts47andres/exeggutor 1.1.2

package/packages/backend/dist/workspaceDb.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDatabase = readDatabase;
+exports.writeDatabase = writeDatabase;
+exports.getWorkspaces = getWorkspaces;
+exports.createWorkspace = createWorkspace;
+exports.deleteWorkspace = deleteWorkspace;
+exports.updateWorkspace = updateWorkspace;
+exports.createTerminalTab = createTerminalTab;
+exports.deleteTerminalTab = deleteTerminalTab;
+exports.updateTerminalTab = updateTerminalTab;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const dbPath = path.join(os.homedir(), '.exeggutor-sessions.json'); // Absolute system path pointing to the sessions flat-file JSON database.
+// Reads and parses the sessions database from the local file system.
+function readDatabase() {
+    if (!fs.existsSync(dbPath)) {
+        const initialDb = { workspaces: [] }; // The initial structural database template to write when the file does not exist.
+        fs.writeFileSync(dbPath, JSON.stringify(initialDb, null, 2), 'utf8');
+        return initialDb;
+    }
+    const rawData = fs.readFileSync(dbPath, 'utf8'); // Loaded string content from the session JSON file.
+    const parsed = JSON.parse(rawData); // Parsed sessions database schema object.
+    return parsed;
+}
+// Serializes and saves the database state back to the local file system.
+function writeDatabase(db) {
+    const serialized = JSON.stringify(db, null, 2); // Serialized JSON string of the session database structure.
+    const tempPath = dbPath + '.tmp'; // Temporary file path to write.
+    fs.writeFileSync(tempPath, serialized, 'utf8');
+    fs.renameSync(tempPath, dbPath);
+}
+// Retrieves all workspaces registered in the database.
+function getWorkspaces() {
+    const db = readDatabase(); // The current session database instance loaded from disk.
+    const list = db.workspaces; // The list of workspaces extracted from the loaded database.
+    return list;
+}
+// Creates a new workspace and initializes it in the persistent database.
+function createWorkspace(name, folderPath) {
+    const db = readDatabase(); // The active database object loaded from persistent storage.
+    const newWorkspace = {
+        id: 'ws_' + Math.random().toString(36).substring(2, 9), // Dynamically generated unique workspace ID string.
+        name: name, // The workspace name passed as a parameter.
+        path: path.resolve(folderPath), // Resolved absolute path string.
+        tabs: [], // Initialized empty list of terminal tabs.
+    }; // The new workspace structure to append.
+    db.workspaces.push(newWorkspace);
+    if (!db.activeWorkspaceId) {
+        db.activeWorkspaceId = newWorkspace.id; // Sets the first workspace as the default active workspace.
+    }
+    writeDatabase(db);
+    const result = newWorkspace; // The created workspace returned to caller.
+    return result;
+}
+// Deletes a workspace by its ID from the persistent database.
+function deleteWorkspace(id) {
+    const db = readDatabase(); // The current database structure loaded from disk.
+    const filtered = db.workspaces.filter(ws => ws.id !== id); // Filtered array of workspaces excluding the target workspace ID.
+    db.workspaces = filtered;
+    if (db.activeWorkspaceId === id) {
+        const fallbackId = db.workspaces.length > 0 ? db.workspaces[0].id : undefined; // Fallback workspace ID if the deleted one was active.
+        db.activeWorkspaceId = fallbackId;
+    }
+    writeDatabase(db);
+}
+// Updates details of an existing workspace in the database.
+function updateWorkspace(id, updates) {
+    const db = readDatabase(); // The loaded session database object.
+    const wsIndex = db.workspaces.findIndex(ws => ws.id === id); // Index of the target workspace in the array.
+    if (wsIndex === -1) {
+        const nullResult = null; // Represents a missing workspace lookup outcome.
+        return nullResult;
+    }
+    const updatedWs = { ...db.workspaces[wsIndex], ...updates }; // Blended workspace object with updated values.
+    db.workspaces[wsIndex] = updatedWs;
+    writeDatabase(db);
+    const result = updatedWs; // Returns the updated workspace structure.
+    return result;
+}
+// Creates a new terminal tab under a specific workspace in the database.
+function createTerminalTab(workspaceId, name, cwd, shell) {
+    const db = readDatabase(); // The database session object retrieved from file system.
+    const ws = db.workspaces.find(w => w.id === workspaceId); // Workspace object referenced by workspaceId.
+    if (!ws) {
+        const errorResult = null; // Represents a failure to find the workspace.
+        return errorResult;
+    }
+    const newTab = {
+        id: 'tab_' + Math.random().toString(36).substring(2, 9), // Dynamically generated unique tab ID string.
+        name: name, // User assigned name of the terminal tab.
+        cwd: path.resolve(cwd), // Resolved absolute current working directory.
+        shell: shell, // The optional custom shell path override.
+    }; // The new terminal tab object to be created.
+    ws.tabs.push(newTab);
+    writeDatabase(db);
+    const result = newTab; // Returns the newly created terminal tab.
+    return result;
+}
+// Deletes a terminal tab from a workspace in the database.
+function deleteTerminalTab(workspaceId, tabId) {
+    const db = readDatabase(); // The database state loaded from sessions.json.
+    const ws = db.workspaces.find(w => w.id === workspaceId); // Target workspace object.
+    if (ws) {
+        const filteredTabs = ws.tabs.filter(t => t.id !== tabId); // Filtered terminal tabs excluding the target tab ID.
+        ws.tabs = filteredTabs;
+        writeDatabase(db);
+    }
+}
+// Updates details of an existing terminal tab in a workspace.
+function updateTerminalTab(workspaceId, tabId, updates) {
+    const db = readDatabase(); // The loaded session database object.
+    const ws = db.workspaces.find(w => w.id === workspaceId); // Target workspace instance.
+    if (!ws) {
+        const errorResult = null; // Target workspace not found.
+        return errorResult;
+    }
+    const tabIndex = ws.tabs.findIndex(t => t.id === tabId); // Index of the target tab.
+    if (tabIndex === -1) {
+        const errorResult = null; // Target tab not found.
+        return errorResult;
+    }
+    const updatedTab = { ...ws.tabs[tabIndex], ...updates }; // Blended terminal tab configuration.
+    ws.tabs[tabIndex] = updatedTab;
+    writeDatabase(db);
+    const result = updatedTab; // Returns the updated tab structure.
+    return result;
+}

package/packages/backend/git-wrapper/git

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+REAL_GIT=$(command -v git 2>/dev/null)
+if [ -z "$REAL_GIT" ]; then
+    REAL_GIT=$(which git 2>/dev/null)
+fi
+if [ -z "$REAL_GIT" ]; then
+    echo "ERROR: git not found" >&2
+    exit 1
+fi
+
+is_branch_delete() {
+    local args=("$@")
+    if [ ${#args[@]} -lt 3 ]; then
+        return 1
+    fi
+    if [ "${args[0]}" != "branch" ]; then
+        return 1
+    fi
+    local i
+    for ((i=1; i<${#args[@]}-1; i++)); do
+        local flag="${args[$i]}"
+        if [ "$flag" = "-d" ] || [ "$flag" = "-D" ] || [ "$flag" = "--delete" ]; then
+            local next_idx=$((i+1))
+            local next="${args[$next_idx]}"
+            if [ "${next:0:1}" != "-" ]; then
+                echo "$next"
+                return 0
+            fi
+        fi
+    done
+    return 1
+}
+
+BRANCH=$(is_branch_delete "$@")
+if [ $? -eq 0 ] && [ -n "$BRANCH" ]; then
+    CONFIG_PATH="$HOME/.exeggutor.json"
+    PORT=17492
+    TOKEN=""
+    if [ -f "$CONFIG_PATH" ]; then
+        CONF_PORT=$(grep -o '"backendPort"[[:space:]]*:[[:space:]]*[0-9]*' "$CONFIG_PATH" | grep -o '[0-9]*')
+        if [ -n "$CONF_PORT" ]; then
+            PORT=$CONF_PORT
+        fi
+        CONF_TOKEN=$(grep -o '"authToken"[[:space:]]*:[[:space:]]*"[^"]*"' "$CONFIG_PATH" | head -n 1 | cut -d '"' -f 4)
+        if [ -n "$CONF_TOKEN" ]; then
+            TOKEN=$CONF_TOKEN
+        fi
+    fi
+    RESPONSE=$(curl -sf -H "Authorization: Bearer $TOKEN" "http://localhost:$PORT/api/branches/in-use?name=$BRANCH" 2>/dev/null)
+    if [ $? -ne 0 ]; then
+        echo "ERROR: Cannot verify branch status. Exeggutor backend must be running. Branch deletion blocked for safety." >&2
+        exit 1
+    fi
+    if echo "$RESPONSE" | grep -q '"inUse":true'; then
+        echo "ERROR: Branch '$BRANCH' is in use by an active Exeggutor terminal. Switch the tab to another branch or close it first." >&2
+        exit 1
+    fi
+fi
+
+exec "$REAL_GIT" "$@"

package/packages/backend/native/FolderPicker.cs

@@ -0,0 +1,139 @@
+using System;
+using System.Runtime.InteropServices;
+using System.Threading;
+
+// Native folder picker using IFileOpenDialog COM interface with FOS_PICKFOLDERS.
+// Shows the modern Windows folder selection dialog available since Vista.
+// Runs on its own STA thread to ensure proper COM apartment initialization.
+// Exit codes:
+//   0 = Success, selected path printed to stdout.
+//   1 = Error (message printed to stderr).
+//   2 = User cancelled (no output).
+
+[ComImport, Guid("DC1C5A9C-E88A-4dde-A5A1-60F82A20AEF7")]
+class FileOpenDialogRCW { }
+
+[ComImport, Guid("d57c7288-d4ad-4768-be02-9d969532d960")]
+[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+interface IFileOpenDialog
+{
+    [PreserveSig] int Show(IntPtr parent); // IModalWindow
+    [PreserveSig] int SetFileTypes();
+    [PreserveSig] int SetFileTypeIndex(int iFileType);
+    [PreserveSig] int GetFileTypeIndex(out int piFileType);
+    [PreserveSig] int Advise();
+    [PreserveSig] int Unadvise();
+    [PreserveSig] int SetOptions(uint fos);
+    [PreserveSig] int GetOptions(out uint pfos);
+    [PreserveSig] int SetDefaultFolder([MarshalAs(UnmanagedType.Interface)] IShellItem psi);
+    [PreserveSig] int SetFolder([MarshalAs(UnmanagedType.Interface)] IShellItem psi);
+    [PreserveSig] int GetFolder([MarshalAs(UnmanagedType.Interface)] out IShellItem ppsi);
+    [PreserveSig] int GetCurrentSelection([MarshalAs(UnmanagedType.Interface)] out IShellItem ppsi);
+    [PreserveSig] int SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);
+    [PreserveSig] int GetFileName([MarshalAs(UnmanagedType.LPWStr)] out string pszName);
+    [PreserveSig] int SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);
+    [PreserveSig] int SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);
+    [PreserveSig] int SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);
+    [PreserveSig] int GetResult([MarshalAs(UnmanagedType.Interface)] out IShellItem ppsi);
+    [PreserveSig] int AddPlace([MarshalAs(UnmanagedType.Interface)] IShellItem psi, int alignment);
+    [PreserveSig] int SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);
+    [PreserveSig] int Close(int hr);
+    [PreserveSig] int SetClientGuid();
+    [PreserveSig] int ClearClientData();
+    [PreserveSig] int SetFilter([MarshalAs(UnmanagedType.IUnknown)] object pFilter);
+    [PreserveSig] int GetResults([MarshalAs(UnmanagedType.Interface)] out IShellItemArray ppenum);
+    [PreserveSig] int GetSelectedItems([MarshalAs(UnmanagedType.IUnknown)] out object ppsai);
+}
+
+[ComImport, Guid("43826D1E-E718-42EE-BC55-A1E261C37BFE")]
+[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+interface IShellItem
+{
+    [PreserveSig] int BindToHandler();
+    [PreserveSig] int GetParent();
+    [PreserveSig] int GetDisplayName(uint sigdnName, [MarshalAs(UnmanagedType.LPWStr)] out string ppszName);
+    [PreserveSig] int GetAttributes();
+    [PreserveSig] int Compare();
+}
+
+[ComImport, Guid("b63ea76d-1f85-456f-a19c-48159efa858b")]
+[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+interface IShellItemArray
+{
+    [PreserveSig] int BindToHandler();
+    [PreserveSig] int GetPropertyStore();
+    [PreserveSig] int GetPropertyDescriptionList();
+    [PreserveSig] int GetAttributes();
+    [PreserveSig] int GetCount(out int pdwNumItems);
+    [PreserveSig] int GetItemAt(int dwIndex, [MarshalAs(UnmanagedType.Interface)] out IShellItem ppsi);
+    [PreserveSig] int EnumItems();
+}
+
+class FolderPicker
+{
+    [DllImport("user32.dll")]
+    static extern IntPtr GetForegroundWindow();
+
+    const uint FOS_PICKFOLDERS = 0x20;
+    const uint SIGDN_FILESYSPATH = 0x80058000;
+    const int ERROR_CANCELLED = unchecked((int)0x800704C7);
+
+    // Entry point; creates the folder picker COM dialog on an STA thread then exits with the result code.
+    static void Main()
+    {
+        string selectedPath = null; // The folder path selected by the user, or null on cancel/error.
+        Exception caughtError = null; // Any exception caught during dialog display.
+
+        Thread staThread = new Thread(() => // STA thread required by COM for the folder picker dialog.
+        {
+            try
+            {
+                IFileOpenDialog dialog = (IFileOpenDialog)new FileOpenDialogRCW(); // The IFileOpenDialog COM interface instance.
+
+                dialog.SetOptions(FOS_PICKFOLDERS);
+                dialog.SetTitle("Select Workspace Folder");
+
+                IntPtr parentHwnd = GetForegroundWindow(); // Handle of the browser window that triggered the dialog.
+                int hr = dialog.Show(parentHwnd); // HRESULT from the dialog; 0 = OK, ERROR_CANCELLED = user cancelled.
+                if (hr == ERROR_CANCELLED)
+                {
+                    return;
+                }
+                if (hr != 0)
+                {
+                    Marshal.ThrowExceptionForHR(hr);
+                }
+
+                IShellItem result; // The IShellItem representing the selected folder.
+                dialog.GetResult(out result);
+
+                string path; // The filesystem path string extracted from the shell item.
+                result.GetDisplayName(SIGDN_FILESYSPATH, out path);
+                selectedPath = path;
+            }
+            catch (Exception ex)
+            {
+                caughtError = ex;
+            }
+        });
+
+        staThread.SetApartmentState(ApartmentState.STA);
+        staThread.Start();
+        staThread.Join();
+
+        if (caughtError != null)
+        {
+            Console.Error.Write("ERROR: " + caughtError.Message);
+            Environment.Exit(1);
+        }
+        if (selectedPath != null)
+        {
+            Console.Write(selectedPath);
+            Environment.Exit(0);
+        }
+        else
+        {
+            Environment.Exit(2);
+        }
+    }
+}

package/packages/backend/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "backend",
+  "version": "1.0.0",
+  "private": true,
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "ts-node-dev --respawn --transpile-only src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "compile-picker": "node scripts/compile-picker.js",
+    "postinstall": "node scripts/compile-picker.js"
+  },
+  "dependencies": {
+    "@fastify/cors": "^9.0.1",
+    "@fastify/static": "^7.0.4",
+    "@fastify/websocket": "^10.0.1",
+    "fastify": "^4.28.1",
+    "node-pty": "^1.1.0-beta21"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.9",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.5.2"
+  }
+}

package/packages/backend/scripts/compile-picker.js

@@ -0,0 +1,61 @@
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// FolderPicker is Windows-only; skip silently on other platforms.
+if (process.platform !== 'win32') {
+  process.exit(0);
+}
+
+const SOURCE = path.join(__dirname, '..', 'native', 'FolderPicker.cs'); // Path to the C# source file.
+const OUTPUT = path.join(__dirname, '..', 'bin', 'FolderPicker.exe'); // Output path for the compiled binary.
+
+const windir = process.env.windir || 'C:\\Windows'; // Windows directory, defaulting to C:\Windows.
+const CSC_PATHS = [ // Candidate paths for the C# compiler executable.
+  path.join(windir, 'Microsoft.NET', 'Framework64', 'v4.0.30319', 'csc.exe'),
+  path.join(windir, 'Microsoft.NET', 'Framework', 'v4.0.30319', 'csc.exe'),
+];
+
+// Locates the C# compiler executable from the known .NET Framework SDK paths.
+function findCsc() {
+  return CSC_PATHS.find(p => fs.existsSync(p));
+}
+
+// Compiles FolderPicker.cs into a winexe binary using the .NET Framework C# compiler.
+function compile() {
+  const csc = findCsc(); // The located csc.exe path, or undefined if not found.
+
+  if (!csc) {
+    console.error(
+      'Warning: C# compiler (csc.exe) not found.\n' +
+      'The Browse folder button will not be available.\n' +
+      'Install .NET Framework SDK or use Visual Studio Build Tools to enable it.\n' +
+      'You can still type workspace paths manually.'
+    );
+    return false;
+  }
+
+  const outDir = path.dirname(OUTPUT); // Parent directory for the output binary.
+
+  if (!fs.existsSync(outDir)) {
+    fs.mkdirSync(outDir, { recursive: true });
+  }
+
+  try {
+    execFileSync(csc, [
+      '/nologo',
+      '/target:winexe',
+      '/platform:anycpu',
+      `/out:${OUTPUT}`,
+      SOURCE,
+    ], { stdio: 'inherit' });
+
+    console.log(`Folder picker compiled successfully: ${OUTPUT}`);
+    return true;
+  } catch (err) {
+    console.error('Failed to compile folder picker:', err.message);
+    return false;
+  }
+}
+
+compile();

package/packages/backend/scripts/git-guard.ps1

@@ -0,0 +1,48 @@
+function global:git {
+    param(
+        [Parameter(ValueFromRemainingArguments = $true)]
+        [string[]]$UserArgs
+    )
+
+    $isBranchDelete = $false
+    $targetBranch = $null
+
+    if ($UserArgs.Count -ge 3 -and $UserArgs[0] -eq 'branch') {
+        for ($i = 1; $i -lt $UserArgs.Count - 1; $i++) {
+            $arg = $UserArgs[$i]
+            if ($arg -eq '-d' -or $arg -eq '-D' -or $arg -eq '--delete') {
+                $nextIdx = $i + 1
+                if ($nextIdx -lt $UserArgs.Count -and $UserArgs[$nextIdx] -notlike '-*') {
+                    $isBranchDelete = $true
+                    $targetBranch = $UserArgs[$nextIdx]
+                    break
+                }
+            }
+        }
+    }
+
+    if ($isBranchDelete -and $targetBranch) {
+        try {
+            $configPath = Join-Path $env:USERPROFILE ".exeggutor.json"
+            $port = 17492
+            $token = ""
+            if (Test-Path $configPath) {
+                $config = Get-Content $configPath -Raw | ConvertFrom-Json
+                if ($config.backendPort) { $port = $config.backendPort }
+                if ($config.authToken) { $token = $config.authToken }
+            }
+            $headers = @{ Authorization = "Bearer $token" }
+            $response = Invoke-RestMethod -Uri "http://localhost:$port/api/branches/in-use?name=$targetBranch" -Headers $headers -ErrorAction Stop
+            if ($response.inUse -eq $true) {
+                Write-Error "Branch '$targetBranch' is in use by an active Exeggutor terminal. Switch the tab to another branch or close it first."
+                return
+            }
+        }
+        catch {
+            Write-Error "Cannot verify branch status. Exeggutor backend must be running. Branch deletion blocked for safety."
+            return
+        }
+    }
+
+    & "git.exe" @UserArgs
+}