@sudocode-ai/local-server 0.1.7 → 0.1.9

package/dist/services/project-registry.js

@@ -0,0 +1,289 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { Ok, Err } from '../types/project.js';
+function getDefaultConfig() {
+    return {
+        version: 1,
+        projects: {},
+        recentProjects: [],
+        settings: {
+            maxRecentProjects: 10,
+            autoOpenLastProject: false,
+        },
+    };
+}
+/**
+ * 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 class ProjectRegistry {
+    configPath;
+    config;
+    /**
+     * Create a new ProjectRegistry instance
+     * @param configPath - Optional custom config file path (defaults to ~/.config/sudocode/projects.json)
+     */
+    constructor(configPath) {
+        this.configPath = configPath || this.getDefaultConfigPath();
+        this.config = getDefaultConfig();
+    }
+    /**
+     * Get the default config file path following XDG Base Directory specification
+     */
+    getDefaultConfigPath() {
+        const configDir = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config', 'sudocode');
+        return path.join(configDir, 'projects.json');
+    }
+    /**
+     * Load configuration from disk. Creates default config if file doesn't exist.
+     * @throws {Error} If config file is corrupted or unreadable
+     */
+    async load() {
+        try {
+            // Ensure config directory exists
+            const configDir = path.dirname(this.configPath);
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true });
+            }
+            // Load existing config or create default
+            if (fs.existsSync(this.configPath)) {
+                const data = fs.readFileSync(this.configPath, 'utf-8');
+                try {
+                    this.config = JSON.parse(data);
+                    // Validate config structure
+                    if (!this.config.version || !this.config.projects || !this.config.settings) {
+                        throw new Error('Invalid config structure');
+                    }
+                }
+                catch (parseError) {
+                    // Config is corrupted, backup and create fresh
+                    const backupPath = `${this.configPath}.backup.${Date.now()}`;
+                    fs.copyFileSync(this.configPath, backupPath);
+                    console.warn(`Corrupted config backed up to: ${backupPath}`);
+                    this.config = getDefaultConfig();
+                    await this.save();
+                }
+            }
+            else {
+                // Create default config
+                await this.save();
+            }
+            return Ok(undefined);
+        }
+        catch (error) {
+            if (error.code === 'EACCES') {
+                return Err({
+                    type: 'PERMISSION_DENIED',
+                    path: this.configPath,
+                });
+            }
+            return Err({
+                type: 'UNKNOWN',
+                message: error.message,
+            });
+        }
+    }
+    /**
+     * Save configuration to disk atomically (write to temp file, then rename)
+     */
+    async save() {
+        try {
+            const tempPath = `${this.configPath}.tmp`;
+            const data = JSON.stringify(this.config, null, 2);
+            // Write to temp file
+            fs.writeFileSync(tempPath, data, 'utf-8');
+            // Atomic rename
+            fs.renameSync(tempPath, this.configPath);
+            return Ok(undefined);
+        }
+        catch (error) {
+            if (error.code === 'EACCES') {
+                return Err({
+                    type: 'PERMISSION_DENIED',
+                    path: this.configPath,
+                });
+            }
+            return Err({
+                type: 'UNKNOWN',
+                message: error.message,
+            });
+        }
+    }
+    /**
+     * Generate a deterministic, human-readable project ID from path
+     * Format: <repo-name>-<8-char-hash>
+     * Example: sudocode-a1b2c3d4
+     */
+    generateProjectId(projectPath) {
+        // Extract repo name from path
+        const repoName = path.basename(projectPath);
+        // Create URL-safe version of repo name
+        const safeName = repoName
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '') // Remove leading/trailing dashes
+            .slice(0, 32);
+        // Generate short hash for uniqueness
+        const hash = crypto
+            .createHash('sha256')
+            .update(projectPath)
+            .digest('hex')
+            .slice(0, 8);
+        return `${safeName}-${hash}`;
+    }
+    /**
+     * Register a new project or update existing one
+     * @param projectPath - Absolute path to project root directory
+     * @returns ProjectInfo for the registered project
+     */
+    registerProject(projectPath) {
+        const projectId = this.generateProjectId(projectPath);
+        const sudocodeDir = path.join(projectPath, '.sudocode');
+        const now = new Date().toISOString();
+        // Check if project already exists
+        const existing = this.config.projects[projectId];
+        if (existing) {
+            // Update existing project
+            existing.lastOpenedAt = now;
+            this.addToRecent(projectId);
+            return existing;
+        }
+        // Create new project info
+        const projectInfo = {
+            id: projectId,
+            name: path.basename(projectPath),
+            path: projectPath,
+            sudocodeDir,
+            registeredAt: now,
+            lastOpenedAt: now,
+            favorite: false,
+        };
+        this.config.projects[projectId] = projectInfo;
+        this.addToRecent(projectId);
+        return 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) {
+        if (!this.config.projects[projectId]) {
+            return false;
+        }
+        delete this.config.projects[projectId];
+        // Remove from recent projects
+        this.config.recentProjects = this.config.recentProjects.filter((id) => id !== projectId);
+        return true;
+    }
+    /**
+     * Get project info by ID
+     */
+    getProject(projectId) {
+        return this.config.projects[projectId] || null;
+    }
+    /**
+     * Get all registered projects
+     */
+    getAllProjects() {
+        return Object.values(this.config.projects);
+    }
+    /**
+     * Update the lastOpenedAt timestamp for a project
+     */
+    updateLastOpened(projectId) {
+        const project = this.config.projects[projectId];
+        if (project) {
+            project.lastOpenedAt = new Date().toISOString();
+        }
+    }
+    /**
+     * Add a project to the recent projects list
+     * Maintains the list at maxRecentProjects size with most recent first
+     */
+    addToRecent(projectId) {
+        // Remove if already in list
+        this.config.recentProjects = this.config.recentProjects.filter((id) => id !== projectId);
+        // Add to front
+        this.config.recentProjects.unshift(projectId);
+        // Trim to max size
+        const maxRecent = this.config.settings.maxRecentProjects;
+        if (this.config.recentProjects.length > maxRecent) {
+            this.config.recentProjects = this.config.recentProjects.slice(0, maxRecent);
+        }
+    }
+    /**
+     * Get recent projects (ordered by most recent first)
+     */
+    getRecentProjects() {
+        return this.config.recentProjects
+            .map((id) => this.config.projects[id])
+            .filter((p) => p !== undefined);
+    }
+    /**
+     * 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, updates) {
+        const project = this.config.projects[projectId];
+        if (!project) {
+            return false;
+        }
+        // Only allow updating name and favorite fields
+        if (updates.name !== undefined) {
+            project.name = updates.name;
+        }
+        if (updates.favorite !== undefined) {
+            project.favorite = updates.favorite;
+        }
+        return true;
+    }
+    /**
+     * Toggle favorite status for a project
+     */
+    toggleFavorite(projectId) {
+        const project = this.config.projects[projectId];
+        if (!project) {
+            return false;
+        }
+        project.favorite = !project.favorite;
+        return true;
+    }
+    /**
+     * Get all favorite projects
+     */
+    getFavoriteProjects() {
+        return Object.values(this.config.projects).filter((p) => p.favorite);
+    }
+    /**
+     * Update user settings
+     */
+    updateSettings(settings) {
+        this.config.settings = {
+            ...this.config.settings,
+            ...settings,
+        };
+    }
+    /**
+     * Get current settings
+     */
+    getSettings() {
+        return { ...this.config.settings };
+    }
+    /**
+     * Get the config file path
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+}
+//# sourceMappingURL=project-registry.js.map

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

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

package/dist/services/prompt-resolver.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Prompt resolver service
+ *
+ * Resolves entity references and file mentions in agent prompts:
+ * - Injects [[s-xxxxx]] or @s-xxxxx spec references with markdown content
+ * - Injects [[i-xxxxx]] or @i-xxxxx issue references with markdown content
+ * - Tracks @file mentions but leaves them for agent to handle
+ */
+import type Database from "better-sqlite3";
+/**
+ * Reference types found in prompts
+ */
+export type ReferenceType = "spec" | "issue" | "file";
+/**
+ * A reference found in a prompt
+ */
+export interface PromptReference {
+    type: ReferenceType;
+    id: string;
+    found: boolean;
+    error?: string;
+}
+/**
+ * Result of prompt resolution
+ */
+export interface PromptResolutionResult {
+    resolvedPrompt: string;
+    references: PromptReference[];
+    errors: string[];
+    /** IDs of entities that were expanded (for tracking in follow-ups) */
+    expandedEntityIds: string[];
+}
+/**
+ * PromptResolver service
+ *
+ * Extracts and resolves entity references in agent prompts
+ */
+export declare class PromptResolver {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Resolve all references in a prompt
+     *
+     * @param prompt - The raw prompt with [[entity-id]], @entity-id, and @file references
+     * @param alreadyExpandedIds - Optional set of entity IDs that were already expanded in parent executions
+     * @param implicitIssueId - Optional issue ID to automatically include even if not mentioned in prompt (for issue-based executions)
+     * @returns Resolution result with resolved prompt, references, and errors
+     */
+    resolve(prompt: string, alreadyExpandedIds?: Set<string>, implicitIssueId?: string): Promise<PromptResolutionResult>;
+    /**
+     * Extract spec references from prompt
+     * Supports two patterns:
+     * - [[s-xxxxx]] (bracket syntax)
+     * - @s-xxxxx (@ mention syntax)
+     */
+    private extractSpecReferences;
+    /**
+     * Extract issue references from prompt
+     * Supports two patterns:
+     * - [[i-xxxxx]] (bracket syntax)
+     * - @i-xxxxx (@ mention syntax)
+     */
+    private extractIssueReferences;
+    /**
+     * Extract file mentions from prompt
+     * Pattern: @filepath (but not @s-xxxxx or @i-xxxxx)
+     *
+     * Note: File mentions are tracked but not resolved (agent handles them)
+     */
+    private extractFileMentions;
+    /**
+     * Replace a reference with formatted content
+     * Handles both [[id]] and @id syntaxes
+     */
+    private replaceReference;
+    /**
+     * Format spec - returns all information shown in CLI show command
+     */
+    private formatSpec;
+    /**
+     * Format issue - returns all information shown in CLI show command
+     */
+    private formatIssue;
+    /**
+     * Get tags for an entity
+     */
+    private getTags;
+    /**
+     * Get outgoing relationships for an entity
+     */
+    private getOutgoingRelationships;
+    /**
+     * Get incoming relationships for an entity
+     */
+    private getIncomingRelationships;
+}
+//# sourceMappingURL=prompt-resolver.d.ts.map

package/dist/services/prompt-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resolver.d.ts","sourceRoot":"","sources":["../../src/services/prompt-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC;;;;;;;OAOG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,kBAAkB,GAAE,GAAG,CAAC,MAAM,CAAa,EAC3C,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,sBAAsB,CAAC;IAyHlC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAqDlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAyDnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAmBjC"}