@emaenriquez/projectmanager-cli 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# Project Hub
+
+A CLI/TUI application for managing development projects across multiple technologies.
+
+## Features
+
+- **Project Scanning**: Automatically detect projects by scanning directories for config files (package.json, Cargo.toml, go.mod, etc.)
+- **Technology Detection**: Identifies languages, frameworks, and tools used in each project
+- **TUI Interface**: Interactive terminal UI with project list, details panel, and keyboard shortcuts
+- **CLI Commands**: Full command-line interface for scripting and automation
+- **Git Integration**: Shows branch, uncommitted changes, and unpushed commits
+- **Tags & Favorites**: Organize projects with custom tags and mark favorites
+- **Search & Filter**: Find projects quickly by name, technology, or tag
+- **System Diagnostics**: `doctor` command to verify installed tools and database health
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Run in TUI mode (interactive)
+npm run dev
+
+# Run CLI commands
+npm run dev -- scan C:\path\to\projects
+npm run dev -- add C:\path\to\project
+npm run dev -- doctor
+npm run dev -- --help
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `scan [path]` | Scan a directory for projects |
+| `add <path>` | Add a single project by path |
+| `remove <id>` | Remove a project |
+| `open <id> [--with <tool>]` | Open a project in an editor |
+| `doctor` | Run system diagnostics |
+| `sync` | Sync all projects (remove missing, update metadata) |
+| `config list` | Show all configurations |
+| `config get <key>` | Get a config value |
+| `config set <key> <value>` | Set a config value |
+| `config reset` | Reset config to defaults |
+
+## TUI Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `↑/↓` | Navigate project list |
+| `Enter` / `D` | View project details |
+| `A` | Add a project by path |
+| `S` | Scan a directory |
+| `F` | Search/filter projects |
+| `*` | Toggle favorite |
+| `T` | Add tag to project |
+| `O` | Open project in editor |
+| `X` | Delete project |
+| `R` | Refresh list |
+| `Q` / `Esc` | Quit |
+
+## Architecture
+
+The project follows **Clean Architecture** principles:
+
+```
+src/
+├── domain/           # Business entities, services (ProjectScanner, TechnologyDetector, GitService)
+├── application/      # Use cases (ScanProjects, AddProject, etc.), state management, error handling
+├── infrastructure/   # Database (SQLite), repositories, UI framework (Blessed)
+└── ui/               # CLI (Commander.js), TUI components, views
+```
+
+## Tech Stack
+
+- **Runtime**: Node.js + TypeScript
+- **Database**: SQLite via better-sqlite3
+- **CLI Framework**: Commander.js
+- **TUI Framework**: Blessed
+- **Testing**: Jest
+
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/dist/application/ConfigManager.d.ts

@@ -0,0 +1,73 @@
+import { Config, DeepConfigKey } from '../domain/types/Config';
+/**
+ * ConfigManager - Manages application configuration
+ *
+ * Responsibilities:
+ * - Load configuration from default and user-saved files
+ * - Provide get/set/reset operations
+ * - Validate configuration values
+ * - Persist configuration to disk
+ * - Merge defaults with user-saved configuration
+ */
+export declare class ConfigManager {
+    private config;
+    private defaultConfig;
+    private configPath;
+    private defaultConfigPath;
+    constructor(defaultConfigPath?: string, userConfigDir?: string);
+    /**
+     * Expand ~ to home directory path
+     */
+    private expandHomePath;
+    /**
+     * Load default configuration from default.json
+     */
+    private loadDefaultConfig;
+    /**
+     * Load user configuration or initialize with defaults
+     */
+    private loadOrInitializeConfig;
+    /**
+     * Deep merge default and user configurations
+     */
+    private deepMerge;
+    /**
+     * Clone configuration object deeply
+     */
+    private cloneConfig;
+    /**
+     * Get configuration value by key
+     * Supports nested keys like "app.name"
+     */
+    get(key: DeepConfigKey): any;
+    /**
+     * Get entire configuration
+     */
+    getAll(): Config;
+    /**
+     * Set configuration value
+     * Supports nested keys like "app.name"
+     */
+    set(key: DeepConfigKey, value: any): void;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): void;
+    /**
+     * Validate configuration value before setting
+     */
+    private validateConfigValue;
+    /**
+     * Persist configuration to disk
+     */
+    private persist;
+    /**
+     * Get configuration file path
+     */
+    getConfigPath(): string;
+    /**
+     * Get default configuration file path
+     */
+    getDefaultConfigPath(): string;
+}
+//# sourceMappingURL=ConfigManager.d.ts.map

package/dist/application/ConfigManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/application/ConfigManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,iBAAiB,GAAE,MAA0D,EAC7E,aAAa,GAAE,MAA8C;IAY/D;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG;IAe5B;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAsBzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,OAAO;IAYf;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,oBAAoB,IAAI,MAAM;CAG/B"}

package/dist/application/ConfigManager.js

@@ -0,0 +1,253 @@
+"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.ConfigManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * ConfigManager - Manages application configuration
+ *
+ * Responsibilities:
+ * - Load configuration from default and user-saved files
+ * - Provide get/set/reset operations
+ * - Validate configuration values
+ * - Persist configuration to disk
+ * - Merge defaults with user-saved configuration
+ */
+class ConfigManager {
+    constructor(defaultConfigPath = path.join(__dirname, '../../config/default.json'), userConfigDir = this.expandHomePath('~/.project-hub')) {
+        this.defaultConfigPath = defaultConfigPath;
+        this.configPath = path.join(userConfigDir, 'config.json');
+        // Load default configuration
+        this.defaultConfig = this.loadDefaultConfig();
+        // Load user configuration or use defaults
+        this.config = this.loadOrInitializeConfig();
+    }
+    /**
+     * Expand ~ to home directory path
+     */
+    expandHomePath(filepath) {
+        if (filepath === '~') {
+            return process.env.HOME || process.env.USERPROFILE || '';
+        }
+        if (filepath.startsWith('~/')) {
+            return path.join(process.env.HOME || process.env.USERPROFILE || '', filepath.slice(2));
+        }
+        return filepath;
+    }
+    /**
+     * Load default configuration from default.json
+     */
+    loadDefaultConfig() {
+        try {
+            const configContent = fs.readFileSync(this.defaultConfigPath, 'utf-8');
+            return JSON.parse(configContent);
+        }
+        catch (error) {
+            throw new Error(`Failed to load default configuration: ${error}`);
+        }
+    }
+    /**
+     * Load user configuration or initialize with defaults
+     */
+    loadOrInitializeConfig() {
+        // Ensure config directory exists
+        const configDir = path.dirname(this.configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        // If user config exists, load and merge with defaults
+        if (fs.existsSync(this.configPath)) {
+            try {
+                const userConfig = JSON.parse(fs.readFileSync(this.configPath, 'utf-8'));
+                return this.deepMerge(this.defaultConfig, userConfig);
+            }
+            catch (error) {
+                // If loading fails, return defaults and log warning
+                console.warn(`Failed to load user config, using defaults: ${error}`);
+                return this.cloneConfig(this.defaultConfig);
+            }
+        }
+        // Return defaults if no user config exists
+        return this.cloneConfig(this.defaultConfig);
+    }
+    /**
+     * Deep merge default and user configurations
+     */
+    deepMerge(defaultConfig, userConfig) {
+        const result = this.cloneConfig(defaultConfig);
+        for (const key in userConfig) {
+            if (key in result) {
+                if (typeof userConfig[key] === 'object' && userConfig[key] !== null) {
+                    result[key] = {
+                        ...result[key],
+                        ...userConfig[key],
+                    };
+                }
+                else {
+                    result[key] = userConfig[key];
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Clone configuration object deeply
+     */
+    cloneConfig(config) {
+        return JSON.parse(JSON.stringify(config));
+    }
+    /**
+     * Get configuration value by key
+     * Supports nested keys like "app.name"
+     */
+    get(key) {
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value && typeof value === 'object' && k in value) {
+                value = value[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return value;
+    }
+    /**
+     * Get entire configuration
+     */
+    getAll() {
+        return this.cloneConfig(this.config);
+    }
+    /**
+     * Set configuration value
+     * Supports nested keys like "app.name"
+     */
+    set(key, value) {
+        this.validateConfigValue(key, value);
+        const keys = key.split('.');
+        const lastKey = keys.pop();
+        if (!lastKey) {
+            throw new Error('Invalid configuration key');
+        }
+        let target = this.config;
+        for (const k of keys) {
+            if (!(k in target)) {
+                target[k] = {};
+            }
+            target = target[k];
+        }
+        target[lastKey] = value;
+        this.persist();
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    reset() {
+        this.config = this.cloneConfig(this.defaultConfig);
+        this.persist();
+    }
+    /**
+     * Validate configuration value before setting
+     */
+    validateConfigValue(key, value) {
+        // Theme validation
+        if (key === 'ui.theme') {
+            if (!['dark', 'light'].includes(value)) {
+                throw new Error(`Invalid theme: ${value}. Must be 'dark' or 'light'.`);
+            }
+        }
+        // Logging level validation
+        if (key === 'logging.level') {
+            if (!['debug', 'info', 'warn', 'error'].includes(value)) {
+                throw new Error(`Invalid logging level: ${value}. Must be 'debug', 'info', 'warn', or 'error'.`);
+            }
+        }
+        // Scanner depth validation
+        if (key === 'scanner.depth') {
+            if (typeof value !== 'number' || value < 1) {
+                throw new Error(`Invalid scanner depth: ${value}. Must be a positive number.`);
+            }
+        }
+        // Items per page validation
+        if (key === 'ui.itemsPerPage') {
+            if (typeof value !== 'number' || value < 1) {
+                throw new Error(`Invalid itemsPerPage: ${value}. Must be a positive number.`);
+            }
+        }
+        // Patterns validation
+        if (key === 'scanner.patterns') {
+            if (!Array.isArray(value) || value.some(v => typeof v !== 'string')) {
+                throw new Error('Invalid scanner patterns. Must be an array of strings.');
+            }
+        }
+        // Editors validation
+        if (key === 'tools.editors') {
+            if (!Array.isArray(value) || value.some(v => typeof v !== 'string')) {
+                throw new Error('Invalid editors. Must be an array of strings.');
+            }
+        }
+    }
+    /**
+     * Persist configuration to disk
+     */
+    persist() {
+        try {
+            const configDir = path.dirname(this.configPath);
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true });
+            }
+            fs.writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to persist configuration: ${error}`);
+        }
+    }
+    /**
+     * Get configuration file path
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * Get default configuration file path
+     */
+    getDefaultConfigPath() {
+        return this.defaultConfigPath;
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=ConfigManager.js.map

package/dist/application/ConfigManager.js.map

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

package/dist/application/errors/ErrorHandler.d.ts

@@ -0,0 +1,27 @@
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly isTransient: boolean;
+    readonly recoverySteps: string[];
+    constructor(message: string, code: string, isTransient: boolean, recoverySteps?: string[]);
+}
+export declare class DatabaseError extends AppError {
+    constructor(message: string, isTransient?: boolean);
+}
+export declare class FileSystemError extends AppError {
+    constructor(message: string, isTransient?: boolean);
+}
+export declare class ErrorHandler {
+    /**
+     * Retry a function if it throws a transient error
+     */
+    static withRetry<T>(operation: () => Promise<T> | T, maxRetries?: number, delayMs?: number): Promise<T>;
+    /**
+     * Format error for UI display
+     */
+    static formatError(error: unknown): string;
+}
+/**
+ * Decorator/Wrapper for use cases to handle uncaught exceptions gracefully
+ */
+export declare function withErrorGuard<TArgs extends any[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+//# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/application/errors/ErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/application/errors/ErrorHandler.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,EAAE,OAAO,CAAC;IACrC,SAAgB,aAAa,EAAE,MAAM,EAAE,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAE,MAAM,EAAO;CAQ9F;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe;CAM1D;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe;CAM1D;AAED,qBAAa,YAAY;IACvB;;OAEG;WACiB,SAAS,CAAC,CAAC,EAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,CAAC,CAAC;IAuBb;;OAEG;WACW,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAelD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EACzD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAS7B"}

package/dist/application/errors/ErrorHandler.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = exports.FileSystemError = exports.DatabaseError = exports.AppError = void 0;
+exports.withErrorGuard = withErrorGuard;
+class AppError extends Error {
+    constructor(message, code, isTransient, recoverySteps = []) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.isTransient = isTransient;
+        this.recoverySteps = recoverySteps;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.AppError = AppError;
+class DatabaseError extends AppError {
+    constructor(message, isTransient = false) {
+        super(message, 'DB_ERROR', isTransient, [
+            'Ensure the database file is not locked by another process.',
+            'Check if you have sufficient disk space and permissions.'
+        ]);
+    }
+}
+exports.DatabaseError = DatabaseError;
+class FileSystemError extends AppError {
+    constructor(message, isTransient = false) {
+        super(message, 'FS_ERROR', isTransient, [
+            'Verify the file or directory exists and you have read/write permissions.',
+            'Check if the path is correct.'
+        ]);
+    }
+}
+exports.FileSystemError = FileSystemError;
+class ErrorHandler {
+    /**
+     * Retry a function if it throws a transient error
+     */
+    static async withRetry(operation, maxRetries = 3, delayMs = 1000) {
+        let lastError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error;
+                const isTransient = error instanceof AppError ? error.isTransient : false;
+                if (!isTransient || attempt === maxRetries) {
+                    throw error;
+                }
+                // Exponential backoff
+                await new Promise(resolve => setTimeout(resolve, delayMs * Math.pow(2, attempt - 1)));
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Format error for UI display
+     */
+    static formatError(error) {
+        if (error instanceof AppError) {
+            let msg = `[${error.code}] ${error.message}`;
+            if (error.recoverySteps.length > 0) {
+                msg += '\n\nRecovery Options:\n' + error.recoverySteps.map(s => `- ${s}`).join('\n');
+            }
+            return msg;
+        }
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return String(error);
+    }
+}
+exports.ErrorHandler = ErrorHandler;
+/**
+ * Decorator/Wrapper for use cases to handle uncaught exceptions gracefully
+ */
+function withErrorGuard(fn) {
+    return (...args) => {
+        try {
+            return fn(...args);
+        }
+        catch (error) {
+            console.error(ErrorHandler.formatError(error)); // For CLI/Logs
+            throw error; // Re-throw to be handled by UI layer
+        }
+    };
+}
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/application/errors/ErrorHandler.js.map

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

package/dist/application/state/StateManager.d.ts

@@ -0,0 +1,26 @@
+export interface UIState {
+    selectedProjectId: string | null;
+    sortOrder: 'name' | 'created_at' | 'last_opened';
+    sortDirection: 'ASC' | 'DESC';
+    filters: {
+        name?: string;
+        is_favorite?: boolean;
+        tags?: string[];
+        technologies?: string[];
+    };
+}
+export type StateListener = (state: UIState) => void;
+export declare class StateManager {
+    private state;
+    private listeners;
+    private stateFilePath;
+    constructor();
+    getState(): UIState;
+    updateState(partialState: Partial<UIState>): void;
+    resetState(): void;
+    subscribe(listener: StateListener): () => void;
+    private notifyListeners;
+    private loadState;
+    private saveState;
+}
+//# sourceMappingURL=StateManager.d.ts.map

package/dist/application/state/StateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"","sources":["../../../src/application/state/StateManager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;IACjD,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AASD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAErD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,aAAa,CAAS;;IASvB,QAAQ,IAAI,OAAO;IAInB,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAcjD,UAAU,IAAI,IAAI;IAMlB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAQrD,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;CAWlB"}