@sudocode-ai/local-server 0.1.7 → 0.1.8

package/dist/services/project-manager.js

@@ -0,0 +1,388 @@
+import * as fs from "fs";
+import * as path from "path";
+import { ProjectContext } from "./project-context.js";
+import { initDatabase } from "./db.js";
+import { TransportManager } from "../execution/transport/transport-manager.js";
+import { ExecutionService } from "./execution-service.js";
+import { ExecutionLogsStore } from "./execution-logs-store.js";
+import { WorktreeManager } from "../execution/worktree/manager.js";
+import { getWorktreeConfig } from "../execution/worktree/config.js";
+import { ExecutionLifecycleService } from "./execution-lifecycle.js";
+import { startServerWatcher } from "./watcher.js";
+import { Ok, Err } from "../types/project.js";
+import { broadcastIssueUpdate, broadcastSpecUpdate } from "./websocket.js";
+import { getIssueById } from "./issues.js";
+import { getSpecById } from "./specs.js";
+import { performInitialization, isInitialized, } from "@sudocode-ai/cli/dist/cli/init-commands.js";
+/**
+ * ProjectManager manages the lifecycle of multiple open projects.
+ *
+ * Responsibilities:
+ * - Open and close projects
+ * - Validate project directories
+ * - Cache database connections with TTL eviction
+ * - Track all open projects
+ * - Coordinate with ProjectRegistry for persistence
+ *
+ * Architecture:
+ * - Each open project gets a ProjectContext with isolated services
+ * - Database connections are cached for 30 minutes after project close
+ * - All services (file watcher, executions, etc.) are per-project
+ */
+export class ProjectManager {
+    registry;
+    openProjects = new Map();
+    dbCache = new Map();
+    /** Database connection TTL: 30 minutes */
+    DB_CACHE_TTL = 30 * 60 * 1000;
+    /** Whether file watching is enabled */
+    watchEnabled;
+    constructor(registry, options) {
+        this.registry = registry;
+        this.watchEnabled = options?.watchEnabled ?? true;
+    }
+    /**
+     * Open a project and initialize all its services
+     * @param projectPath - Absolute path to project root directory
+     * @returns ProjectContext for the opened project
+     */
+    async openProject(projectPath) {
+        try {
+            // 1. Validate project structure
+            const validation = this.validateProject(projectPath);
+            if (!validation.ok) {
+                return validation;
+            }
+            // 2. Generate or lookup project ID
+            const projectId = this.registry.generateProjectId(projectPath);
+            // 3. Check if already open
+            const existing = this.openProjects.get(projectId);
+            if (existing) {
+                console.log(`Project already open: ${projectId}`);
+                this.registry.updateLastOpened(projectId);
+                await this.registry.save();
+                return Ok(existing);
+            }
+            // 4. Initialize database (check cache first)
+            const db = await this.getOrCreateDatabase(projectId, projectPath);
+            // 5. Initialize all services for this project
+            const sudocodeDir = path.join(projectPath, ".sudocode");
+            const transportManager = new TransportManager();
+            const logsStore = new ExecutionLogsStore(db);
+            const worktreeConfig = getWorktreeConfig(projectPath);
+            const worktreeManager = new WorktreeManager(worktreeConfig);
+            // NOTE: Worker pool execution is disabled - using in-process execution
+            // Worker pool can be re-enabled by uncommenting the ExecutionWorkerPool creation
+            // and passing it to ExecutionService and ProjectContext
+            // Create execution service without worker pool (will use in-process execution)
+            const executionService = new ExecutionService(db, projectId, projectPath, undefined, transportManager, logsStore, undefined // No worker pool - use in-process execution
+            );
+            // 6. Create project context
+            const context = new ProjectContext(projectId, projectPath, sudocodeDir, db, transportManager, executionService, logsStore, worktreeManager, undefined // No worker pool
+            );
+            await context.initialize();
+            // 7. Start file watcher if enabled
+            if (this.watchEnabled) {
+                context.watcher = startServerWatcher({
+                    db,
+                    baseDir: sudocodeDir,
+                    onFileChange: (info) => {
+                        console.log(`[project-manager] File change in ${projectId}`);
+                        // Broadcast WebSocket updates based on entity type
+                        if (info.entityType && info.entityId) {
+                            if (info.entityType === "issue") {
+                                // Use entity from event if available (optimization)
+                                if (info.entity) {
+                                    broadcastIssueUpdate(projectId, info.entityId, "updated", info.entity);
+                                }
+                                else {
+                                    // Fallback to DB query (for backward compatibility)
+                                    const issue = getIssueById(db, info.entityId);
+                                    if (issue) {
+                                        broadcastIssueUpdate(projectId, info.entityId, "updated", issue);
+                                    }
+                                }
+                            }
+                            else if (info.entityType === "spec") {
+                                // Use entity from event if available (optimization)
+                                if (info.entity) {
+                                    broadcastSpecUpdate(projectId, info.entityId, "updated", info.entity);
+                                }
+                                else {
+                                    // Fallback to DB query (for backward compatibility)
+                                    const spec = getSpecById(db, info.entityId);
+                                    if (spec) {
+                                        broadcastSpecUpdate(projectId, info.entityId, "updated", spec);
+                                    }
+                                }
+                            }
+                        }
+                    },
+                });
+            }
+            // 8. Cleanup orphaned worktrees on first open
+            if (worktreeConfig.cleanupOrphanedWorktreesOnStartup) {
+                try {
+                    const lifecycleService = new ExecutionLifecycleService(db, projectPath, worktreeManager);
+                    await lifecycleService.cleanupOrphanedWorktrees();
+                    console.log(`Cleaned up orphaned worktrees for ${projectId}`);
+                }
+                catch (error) {
+                    console.warn(`Failed to cleanup orphaned worktrees for ${projectId}:`, error);
+                    // Don't fail the open operation
+                }
+            }
+            // 9. Register and track
+            this.registry.registerProject(projectPath);
+            this.registry.updateLastOpened(projectId);
+            await this.registry.save();
+            this.openProjects.set(projectId, context);
+            console.log(`Project opened successfully: ${projectId} at ${projectPath}`);
+            return Ok(context);
+        }
+        catch (error) {
+            console.error(`Failed to open project at ${projectPath}:`, error);
+            return Err({
+                type: "UNKNOWN",
+                message: error.message || String(error),
+            });
+        }
+    }
+    /**
+     * Initialize a new sudocode project in an existing directory
+     * @param projectPath - Absolute path to project root directory
+     * @param name - Optional custom project name
+     * @returns ProjectContext for the initialized and opened project
+     */
+    async initializeProject(projectPath, name) {
+        try {
+            // 1. Check that path exists
+            if (!fs.existsSync(projectPath)) {
+                return Err({
+                    type: "PATH_NOT_FOUND",
+                    path: projectPath,
+                });
+            }
+            // 2. Check that it's a directory
+            const stats = fs.statSync(projectPath);
+            if (!stats.isDirectory()) {
+                return Err({
+                    type: "INVALID_PROJECT",
+                    message: `Path is not a directory: ${projectPath}`,
+                });
+            }
+            // 3. Check if already initialized
+            const sudocodeDir = path.join(projectPath, ".sudocode");
+            if (isInitialized(sudocodeDir)) {
+                // Already initialized, just open it
+                console.log(`Project already initialized at ${projectPath}, opening...`);
+                return this.openProject(projectPath);
+            }
+            // 4. Perform initialization using CLI's performInitialization
+            console.log(`Initializing new project at ${projectPath}`);
+            await performInitialization({
+                dir: sudocodeDir,
+                jsonOutput: true, // Suppress CLI console output
+            });
+            // 5. Update project name in registry if provided
+            const projectId = this.registry.generateProjectId(projectPath);
+            if (name) {
+                this.registry.registerProject(projectPath);
+                this.registry.updateProject(projectId, { name });
+                await this.registry.save();
+            }
+            // 6. Open the newly initialized project
+            return this.openProject(projectPath);
+        }
+        catch (error) {
+            console.error(`Failed to initialize project at ${projectPath}:`, error);
+            return Err({
+                type: "UNKNOWN",
+                message: error.message || String(error),
+            });
+        }
+    }
+    /**
+     * Close a project and cleanup its resources
+     * @param projectId - Project ID to close
+     * @param keepDbInCache - Whether to keep database in cache (default: true)
+     */
+    async closeProject(projectId, keepDbInCache = true) {
+        const context = this.openProjects.get(projectId);
+        if (!context) {
+            console.warn(`Cannot close project ${projectId}: not open`);
+            return;
+        }
+        console.log(`Closing project: ${projectId}`);
+        try {
+            // Shutdown project context (stops watcher, cancels executions, etc.)
+            await context.shutdown();
+            // Keep DB in cache for fast reopening (unless explicitly disabled)
+            if (keepDbInCache) {
+                this.addToDbCache(projectId, context.db);
+            }
+            else {
+                context.db.close();
+            }
+            // Remove from active projects
+            this.openProjects.delete(projectId);
+            // TODO: Broadcast project_closed WebSocket message
+            console.log(`Project closed: ${projectId}`);
+        }
+        catch (error) {
+            console.error(`Error closing project ${projectId}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get an open project by ID
+     */
+    getProject(projectId) {
+        return this.openProjects.get(projectId) || null;
+    }
+    /**
+     * Get all currently open projects
+     */
+    getAllOpenProjects() {
+        return Array.from(this.openProjects.values());
+    }
+    /**
+     * Check if a project is currently open
+     */
+    isProjectOpen(projectId) {
+        return this.openProjects.has(projectId);
+    }
+    /**
+     * Validate that a project directory is valid for opening
+     */
+    validateProject(projectPath) {
+        // Check that path exists
+        if (!fs.existsSync(projectPath)) {
+            return Err({
+                type: "PATH_NOT_FOUND",
+                path: projectPath,
+            });
+        }
+        // Check that it's a directory
+        const stats = fs.statSync(projectPath);
+        if (!stats.isDirectory()) {
+            return Err({
+                type: "INVALID_PROJECT",
+                message: `Path is not a directory: ${projectPath}`,
+            });
+        }
+        // Check that .sudocode directory exists
+        const sudocodeDir = path.join(projectPath, ".sudocode");
+        if (!fs.existsSync(sudocodeDir)) {
+            return Err({
+                type: "INVALID_PROJECT",
+                message: `Missing .sudocode directory: ${sudocodeDir}`,
+            });
+        }
+        // Check that cache.db exists
+        const dbPath = path.join(sudocodeDir, "cache.db");
+        if (!fs.existsSync(dbPath)) {
+            return Err({
+                type: "INVALID_PROJECT",
+                message: `Missing cache.db file: ${dbPath}`,
+            });
+        }
+        return Ok(undefined);
+    }
+    /**
+     * Get or create a database connection for a project
+     * Checks cache first, then initializes new connection
+     */
+    async getOrCreateDatabase(projectId, projectPath) {
+        // Check cache
+        const cached = this.dbCache.get(projectId);
+        if (cached) {
+            console.log(`Using cached database for ${projectId}`);
+            cached.lastAccessed = new Date();
+            // Clear eviction timer since we're using it again
+            if (cached.evictionTimer) {
+                clearTimeout(cached.evictionTimer);
+                cached.evictionTimer = undefined;
+            }
+            // Remove from cache (will be managed by project context)
+            this.dbCache.delete(projectId);
+            return cached.db;
+        }
+        // Initialize new database
+        const dbPath = path.join(projectPath, ".sudocode", "cache.db");
+        console.log(`Initializing new database for ${projectId} at ${dbPath}`);
+        const db = initDatabase({ path: dbPath });
+        return db;
+    }
+    /**
+     * Add a database to the cache with TTL eviction
+     */
+    addToDbCache(projectId, db) {
+        // Clear any existing cache entry
+        const existing = this.dbCache.get(projectId);
+        if (existing?.evictionTimer) {
+            clearTimeout(existing.evictionTimer);
+        }
+        // Add to cache
+        const cached = {
+            db,
+            lastAccessed: new Date(),
+        };
+        // Schedule eviction
+        cached.evictionTimer = setTimeout(() => {
+            const entry = this.dbCache.get(projectId);
+            if (entry) {
+                const age = Date.now() - entry.lastAccessed.getTime();
+                if (age >= this.DB_CACHE_TTL) {
+                    console.log(`Evicting cached database for ${projectId} (age: ${age}ms)`);
+                    try {
+                        entry.db.close();
+                    }
+                    catch (error) {
+                        console.error(`Error closing cached database for ${projectId}:`, error);
+                    }
+                    this.dbCache.delete(projectId);
+                }
+            }
+        }, this.DB_CACHE_TTL);
+        this.dbCache.set(projectId, cached);
+        console.log(`Database cached for ${projectId} (TTL: ${this.DB_CACHE_TTL}ms)`);
+    }
+    /**
+     * Get summary of all projects (open and cached)
+     */
+    getSummary() {
+        return {
+            openProjects: this.getAllOpenProjects().map((p) => p.getSummary()),
+            cachedDatabases: Array.from(this.dbCache.keys()),
+            totalOpen: this.openProjects.size,
+            totalCached: this.dbCache.size,
+        };
+    }
+    /**
+     * Shutdown the project manager and cleanup all resources
+     */
+    async shutdown() {
+        console.log("Shutting down ProjectManager...");
+        // Close all open projects
+        const projectIds = Array.from(this.openProjects.keys());
+        for (const projectId of projectIds) {
+            await this.closeProject(projectId, false); // Don't cache on shutdown
+        }
+        // Close all cached databases
+        for (const [projectId, cached] of this.dbCache.entries()) {
+            if (cached.evictionTimer) {
+                clearTimeout(cached.evictionTimer);
+            }
+            try {
+                cached.db.close();
+            }
+            catch (error) {
+                console.error(`Error closing cached database for ${projectId}:`, error);
+            }
+        }
+        this.dbCache.clear();
+        console.log("ProjectManager shutdown complete");
+    }
+}
+//# sourceMappingURL=project-manager.js.map

package/dist/services/project-manager.js.map

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

package/dist/services/project-registry.d.ts

@@ -0,0 +1,98 @@
+import type { ProjectInfo, ProjectsConfig, ProjectError, Result } from '../types/project.js';
+/**
+ * ProjectRegistry manages the persistent storage of registered projects.
+ *
+ * Configuration is stored at ~/.config/sudocode/projects.json and includes:
+ * - Registered projects with metadata
+ * - Recent projects list
+ * - User settings
+ */
+export declare class ProjectRegistry {
+    private configPath;
+    private config;
+    /**
+     * Create a new ProjectRegistry instance
+     * @param configPath - Optional custom config file path (defaults to ~/.config/sudocode/projects.json)
+     */
+    constructor(configPath?: string);
+    /**
+     * Get the default config file path following XDG Base Directory specification
+     */
+    private getDefaultConfigPath;
+    /**
+     * Load configuration from disk. Creates default config if file doesn't exist.
+     * @throws {Error} If config file is corrupted or unreadable
+     */
+    load(): Promise<Result<void, ProjectError>>;
+    /**
+     * Save configuration to disk atomically (write to temp file, then rename)
+     */
+    save(): Promise<Result<void, ProjectError>>;
+    /**
+     * Generate a deterministic, human-readable project ID from path
+     * Format: <repo-name>-<8-char-hash>
+     * Example: sudocode-a1b2c3d4
+     */
+    generateProjectId(projectPath: string): string;
+    /**
+     * Register a new project or update existing one
+     * @param projectPath - Absolute path to project root directory
+     * @returns ProjectInfo for the registered project
+     */
+    registerProject(projectPath: string): ProjectInfo;
+    /**
+     * Unregister a project (remove from registry)
+     * @param projectId - Project ID to remove
+     * @returns true if project was removed, false if not found
+     */
+    unregisterProject(projectId: string): boolean;
+    /**
+     * Get project info by ID
+     */
+    getProject(projectId: string): ProjectInfo | null;
+    /**
+     * Get all registered projects
+     */
+    getAllProjects(): ProjectInfo[];
+    /**
+     * Update the lastOpenedAt timestamp for a project
+     */
+    updateLastOpened(projectId: string): void;
+    /**
+     * Add a project to the recent projects list
+     * Maintains the list at maxRecentProjects size with most recent first
+     */
+    addToRecent(projectId: string): void;
+    /**
+     * Get recent projects (ordered by most recent first)
+     */
+    getRecentProjects(): ProjectInfo[];
+    /**
+     * Update project metadata
+     * @param projectId - Project ID to update
+     * @param updates - Partial project info to update
+     * @returns true if project was updated, false if not found
+     */
+    updateProject(projectId: string, updates: Partial<Pick<ProjectInfo, 'name' | 'favorite'>>): boolean;
+    /**
+     * Toggle favorite status for a project
+     */
+    toggleFavorite(projectId: string): boolean;
+    /**
+     * Get all favorite projects
+     */
+    getFavoriteProjects(): ProjectInfo[];
+    /**
+     * Update user settings
+     */
+    updateSettings(settings: Partial<ProjectsConfig['settings']>): void;
+    /**
+     * Get current settings
+     */
+    getSettings(): ProjectsConfig['settings'];
+    /**
+     * Get the config file path
+     */
+    getConfigPath(): string;
+}
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/services/project-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.d.ts","sourceRoot":"","sources":["../../src/services/project-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAe5F;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;OAGG;gBACS,UAAU,CAAC,EAAE,MAAM;IAK/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IA+CjD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IA0BjD;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAsB9C;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IA+BjD;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAe7C;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIjD;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAI/B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOzC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBpC;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAMlC;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG,OAAO;IAiBnG;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAU1C;;OAEG;IACH,mBAAmB,IAAI,WAAW,EAAE;IAIpC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI;IAOnE;;OAEG;IACH,WAAW,IAAI,cAAc,CAAC,UAAU,CAAC;IAIzC;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}