projax 3.3.39 → 3.3.41

package/dist/api/types.d.ts

@@ -7,6 +7,7 @@ export interface Project {
     last_scanned: number | null;
     created_at: number;
     tags?: string[];
+    git_branch?: string | null;
 }
 export interface Test {
     id: number;
@@ -50,6 +51,28 @@ export interface TestResult {
     timestamp: number;
     raw_output: string | null;
 }
+export interface Workspace {
+    id: number;
+    name: string;
+    workspace_file_path: string;
+    description: string | null;
+    tags?: string[];
+    created_at: number;
+    last_opened: number | null;
+}
+export interface WorkspaceProject {
+    id: number;
+    workspace_id: number;
+    project_path: string;
+    order: number;
+    created_at: number;
+}
+export interface ProjectSettings {
+    id: number;
+    project_id: number;
+    script_sort_order: 'default' | 'alphabetical' | 'last-used';
+    updated_at: number;
+}
 export interface DatabaseSchema {
     projects: Project[];
     tests: Test[];
@@ -61,5 +84,8 @@ export interface DatabaseSchema {
         value: string;
         updated_at: number;
     }>;
+    workspaces: Workspace[];
+    workspace_projects: WorkspaceProject[];
+    project_settings: ProjectSettings[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/core/backup-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Create a backup of the PROJAX database
+ * @param outputPath Directory where the backup should be created
+ * @returns Path to the created backup file
+ */
+export declare function createBackup(outputPath: string): Promise<string>;
+/**
+ * Restore PROJAX database from a backup file
+ * @param backupPath Path to the .pbz backup file
+ */
+export declare function restoreBackup(backupPath: string): Promise<void>;
+/**
+ * Validate a backup file without restoring
+ * @param backupPath Path to the .pbz backup file
+ * @returns true if valid, throws error if invalid
+ */
+export declare function validateBackup(backupPath: string): Promise<boolean>;

package/dist/core/backup-utils.js

@@ -0,0 +1,166 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBackup = createBackup;
+exports.restoreBackup = restoreBackup;
+exports.validateBackup = validateBackup;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Create a backup of the PROJAX database
+ * @param outputPath Directory where the backup should be created
+ * @returns Path to the created backup file
+ */
+async function createBackup(outputPath) {
+    const dataDir = path.join(os.homedir(), '.projax');
+    const dbPath = path.join(dataDir, 'data.json');
+    if (!fs.existsSync(dbPath)) {
+        throw new Error('PROJAX database not found');
+    }
+    // Generate timestamped filename
+    const now = new Date();
+    const timestamp = now.toISOString().replace(/[:.]/g, '-').slice(0, 19); // YYYY-MM-DDTHHmmss
+    const filename = `projax-backup-${timestamp}.pbz`;
+    const backupPath = path.join(outputPath, filename);
+    // Ensure output directory exists
+    if (!fs.existsSync(outputPath)) {
+        fs.mkdirSync(outputPath, { recursive: true });
+    }
+    // Read database file
+    const dbContent = fs.readFileSync(dbPath, 'utf-8');
+    // Create metadata
+    const metadata = {
+        version: '1.0',
+        timestamp: Math.floor(Date.now() / 1000),
+        projax_version: '3.4.0', // This should ideally come from package.json
+        created_at: now.toISOString(),
+    };
+    // Create ZIP-like structure manually (simple approach)
+    // For a proper ZIP, we'd use a library like adm-zip or archiver
+    // For now, we'll create a simple JSON structure that can be restored
+    const backupData = {
+        metadata,
+        data: JSON.parse(dbContent),
+    };
+    // Write backup file
+    fs.writeFileSync(backupPath, JSON.stringify(backupData, null, 2), 'utf-8');
+    return backupPath;
+}
+/**
+ * Restore PROJAX database from a backup file
+ * @param backupPath Path to the .pbz backup file
+ */
+async function restoreBackup(backupPath) {
+    if (!fs.existsSync(backupPath)) {
+        throw new Error(`Backup file not found: ${backupPath}`);
+    }
+    if (!backupPath.endsWith('.pbz')) {
+        throw new Error('Invalid backup file extension. Expected .pbz');
+    }
+    // Read and parse backup file
+    let backupContent;
+    try {
+        const content = fs.readFileSync(backupPath, 'utf-8');
+        backupContent = JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid backup file format: ${error.message}`);
+        }
+        throw new Error(`Failed to read backup file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    // Validate backup structure
+    if (!backupContent.metadata || !backupContent.data) {
+        throw new Error('Invalid backup file structure: missing metadata or data');
+    }
+    // Validate metadata
+    const metadata = backupContent.metadata;
+    if (!metadata.version || !metadata.timestamp) {
+        throw new Error('Invalid backup metadata');
+    }
+    // Validate data structure (basic check)
+    if (typeof backupContent.data !== 'object' || !Array.isArray(backupContent.data.projects)) {
+        throw new Error('Invalid backup data structure');
+    }
+    // Create backup of current database before restoring
+    const dataDir = path.join(os.homedir(), '.projax');
+    const dbPath = path.join(dataDir, 'data.json');
+    if (fs.existsSync(dbPath)) {
+        const backupTimestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        const currentBackupPath = path.join(dataDir, `data.backup-${backupTimestamp}.json`);
+        fs.copyFileSync(dbPath, currentBackupPath);
+    }
+    // Ensure data directory exists
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    // Write restored data
+    fs.writeFileSync(dbPath, JSON.stringify(backupContent.data, null, 2), 'utf-8');
+}
+/**
+ * Validate a backup file without restoring
+ * @param backupPath Path to the .pbz backup file
+ * @returns true if valid, throws error if invalid
+ */
+async function validateBackup(backupPath) {
+    if (!fs.existsSync(backupPath)) {
+        throw new Error(`Backup file not found: ${backupPath}`);
+    }
+    if (!backupPath.endsWith('.pbz')) {
+        throw new Error('Invalid backup file extension. Expected .pbz');
+    }
+    try {
+        const content = fs.readFileSync(backupPath, 'utf-8');
+        const backupContent = JSON.parse(content);
+        if (!backupContent.metadata || !backupContent.data) {
+            throw new Error('Invalid backup file structure');
+        }
+        const metadata = backupContent.metadata;
+        if (!metadata.version || !metadata.timestamp) {
+            throw new Error('Invalid backup metadata');
+        }
+        if (typeof backupContent.data !== 'object' || !Array.isArray(backupContent.data.projects)) {
+            throw new Error('Invalid backup data structure');
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in backup file: ${error.message}`);
+        }
+        throw error;
+    }
+}

package/dist/core/database.d.ts

@@ -7,6 +7,7 @@ export interface Project {
     last_scanned: number | null;
     created_at: number;
     tags?: string[];
+    git_branch?: string | null;
 }
 export interface Test {
     id: number;

package/dist/core/git-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get the current git branch for a project
+ * @param projectPath The path to the project directory
+ * @returns The current branch name, or null if not a git repo or on error
+ */
+export declare function getCurrentBranch(projectPath: string): string | null;
+/**
+ * Get git branches for multiple projects
+ * @param projectPaths Array of project paths
+ * @returns Map of project path to branch name (or null)
+ */
+export declare function getBranchesForProjects(projectPaths: string[]): Map<string, string | null>;

package/dist/core/git-utils.js

@@ -0,0 +1,96 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentBranch = getCurrentBranch;
+exports.getBranchesForProjects = getBranchesForProjects;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Get the current git branch for a project
+ * @param projectPath The path to the project directory
+ * @returns The current branch name, or null if not a git repo or on error
+ */
+function getCurrentBranch(projectPath) {
+    try {
+        // Check if .git directory exists
+        const gitDir = path.join(projectPath, '.git');
+        if (!fs.existsSync(gitDir) && !fs.existsSync(path.join(projectPath, '.git', 'HEAD'))) {
+            // Check if it's a worktree or submodule
+            const gitConfig = path.join(projectPath, '.git');
+            if (!fs.existsSync(gitConfig)) {
+                return null;
+            }
+        }
+        // Try to get the current branch
+        const branch = (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Handle detached HEAD state (returns "HEAD")
+        if (branch === 'HEAD') {
+            // Try to get the commit hash instead
+            try {
+                const commit = (0, child_process_1.execSync)('git rev-parse --short HEAD', {
+                    cwd: projectPath,
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                return `detached@${commit}`;
+            }
+            catch {
+                return 'detached';
+            }
+        }
+        return branch || null;
+    }
+    catch (error) {
+        // Not a git repo, or git command failed
+        return null;
+    }
+}
+/**
+ * Get git branches for multiple projects
+ * @param projectPaths Array of project paths
+ * @returns Map of project path to branch name (or null)
+ */
+function getBranchesForProjects(projectPaths) {
+    const branches = new Map();
+    for (const projectPath of projectPaths) {
+        branches.set(projectPath, getCurrentBranch(projectPath));
+    }
+    return branches;
+}

package/dist/core/index.d.ts

@@ -2,6 +2,9 @@ export * from './database';
 export * from './detector';
 export * from './scanner';
 export * from './settings';
+export * from './git-utils';
+export * from './workspace-utils';
+export * from './backup-utils';
 export { getDatabaseManager } from './database';
 import { Project, Test } from './database';
 export declare function getAllProjects(): Project[];

package/dist/core/index.js

@@ -23,6 +23,9 @@ __exportStar(require("./database"), exports);
 __exportStar(require("./detector"), exports);
 __exportStar(require("./scanner"), exports);
 __exportStar(require("./settings"), exports);
+__exportStar(require("./git-utils"), exports);
+__exportStar(require("./workspace-utils"), exports);
+__exportStar(require("./backup-utils"), exports);
 var database_1 = require("./database");
 Object.defineProperty(exports, "getDatabaseManager", { enumerable: true, get: function () { return database_1.getDatabaseManager; } });
 // Convenience functions for common operations

package/dist/core/workspace-utils.d.ts

@@ -0,0 +1,37 @@
+export interface WorkspaceFolder {
+    path: string;
+    name?: string;
+}
+export interface WorkspaceSettings {
+    [key: string]: any;
+}
+export interface WorkspaceExtensions {
+    recommendations?: string[];
+    unwantedRecommendations?: string[];
+}
+export interface ParsedWorkspace {
+    folders: WorkspaceFolder[];
+    settings?: WorkspaceSettings;
+    extensions?: WorkspaceExtensions;
+}
+/**
+ * Parse a .code-workspace file
+ * @param filePath Path to the .code-workspace file
+ * @returns Parsed workspace structure
+ */
+export declare function parseWorkspaceFile(filePath: string): ParsedWorkspace;
+/**
+ * Generate a .code-workspace file
+ * @param workspaceName Name of the workspace (used in comments)
+ * @param projects Array of project paths (absolute or relative)
+ * @param outputPath Path where the .code-workspace file should be created
+ * @param settings Optional workspace settings
+ * @param extensions Optional workspace extensions recommendations
+ */
+export declare function generateWorkspaceFile(workspaceName: string, projects: string[], outputPath: string, settings?: WorkspaceSettings, extensions?: WorkspaceExtensions): void;
+/**
+ * Validate that a path is a valid workspace file
+ * @param filePath Path to check
+ * @returns true if the path exists and is a valid .code-workspace file
+ */
+export declare function validateWorkspacePath(filePath: string): boolean;

package/dist/core/workspace-utils.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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWorkspaceFile = parseWorkspaceFile;
+exports.generateWorkspaceFile = generateWorkspaceFile;
+exports.validateWorkspacePath = validateWorkspacePath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Parse a .code-workspace file
+ * @param filePath Path to the .code-workspace file
+ * @returns Parsed workspace structure
+ */
+function parseWorkspaceFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Workspace file not found: ${filePath}`);
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const workspace = JSON.parse(content);
+        // Validate structure
+        if (!workspace.folders || !Array.isArray(workspace.folders)) {
+            throw new Error('Invalid workspace file: missing or invalid folders array');
+        }
+        // Normalize folder paths to absolute paths
+        const workspaceDir = path.dirname(filePath);
+        workspace.folders = workspace.folders.map(folder => {
+            if (typeof folder === 'string') {
+                // Legacy format: folders can be strings
+                const absolutePath = path.isAbsolute(folder)
+                    ? folder
+                    : path.resolve(workspaceDir, folder);
+                return { path: absolutePath };
+            }
+            else {
+                // Modern format: folders are objects with path property
+                const absolutePath = path.isAbsolute(folder.path)
+                    ? folder.path
+                    : path.resolve(workspaceDir, folder.path);
+                return {
+                    ...folder,
+                    path: absolutePath,
+                };
+            }
+        });
+        return workspace;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in workspace file: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Generate a .code-workspace file
+ * @param workspaceName Name of the workspace (used in comments)
+ * @param projects Array of project paths (absolute or relative)
+ * @param outputPath Path where the .code-workspace file should be created
+ * @param settings Optional workspace settings
+ * @param extensions Optional workspace extensions recommendations
+ */
+function generateWorkspaceFile(workspaceName, projects, outputPath, settings, extensions) {
+    const workspaceDir = path.dirname(outputPath);
+    // Convert project paths to relative paths if they're within the workspace directory
+    const folders = projects.map(projectPath => {
+        const absolutePath = path.isAbsolute(projectPath)
+            ? projectPath
+            : path.resolve(process.cwd(), projectPath);
+        // Try to make path relative to workspace directory if possible
+        let relativePath;
+        try {
+            relativePath = path.relative(workspaceDir, absolutePath);
+            // If relative path goes outside workspace dir, use absolute
+            if (relativePath.startsWith('..')) {
+                relativePath = absolutePath;
+            }
+        }
+        catch {
+            relativePath = absolutePath;
+        }
+        return {
+            path: relativePath,
+        };
+    });
+    const workspace = {
+        folders,
+        ...(settings && { settings }),
+        ...(extensions && { extensions }),
+    };
+    // Add comment header
+    const content = JSON.stringify(workspace, null, 2);
+    const withHeader = `// ${workspaceName} Workspace\n${content}`;
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, withHeader, 'utf-8');
+}
+/**
+ * Validate that a path is a valid workspace file
+ * @param filePath Path to check
+ * @returns true if the path exists and is a valid .code-workspace file
+ */
+function validateWorkspacePath(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    if (!filePath.endsWith('.code-workspace')) {
+        return false;
+    }
+    try {
+        parseWorkspaceFile(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/electron/core/backup-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Create a backup of the PROJAX database
+ * @param outputPath Directory where the backup should be created
+ * @returns Path to the created backup file
+ */
+export declare function createBackup(outputPath: string): Promise<string>;
+/**
+ * Restore PROJAX database from a backup file
+ * @param backupPath Path to the .pbz backup file
+ */
+export declare function restoreBackup(backupPath: string): Promise<void>;
+/**
+ * Validate a backup file without restoring
+ * @param backupPath Path to the .pbz backup file
+ * @returns true if valid, throws error if invalid
+ */
+export declare function validateBackup(backupPath: string): Promise<boolean>;