specweave 2.2.3 → 3.0.0

package/dist/src/utils/notification-manager.js

@@ -1,180 +0,0 @@
-/**
- * Notification Manager - Cross-platform system notifications
- *
- * Sends native notifications on macOS, Linux, and Windows
- *
- * IMPORTANT: Use sendStandardNotification() for consistent, explicit notifications!
- * See notification-constants.ts for the standard notification types and messages.
- */
-import { exec } from 'child_process';
-import { consoleLogger } from './logger.js';
-import { buildNotificationMessage, getTitleForType, getSoundForType, } from './notification-constants.js';
-export class NotificationManager {
-    constructor(options = {}) {
-        this.logger = options.logger ?? consoleLogger;
-    }
-    /**
-     * Sends a system notification (cross-platform)
-     *
-     * @param title - Notification title
-     * @param body - Notification message
-     * @param sound - Optional sound name (macOS only)
-     */
-    async sendNotification(title, body, sound) {
-        const platform = process.platform;
-        try {
-            if (platform === 'darwin') {
-                await this.sendMacOSNotification(title, body, sound);
-            }
-            else if (platform === 'linux') {
-                await this.sendLinuxNotification(title, body);
-            }
-            else if (platform === 'win32') {
-                await this.sendWindowsNotification(title, body);
-            }
-            else {
-                this.logger.warn(`Notifications not supported on platform: ${platform}`);
-                this.logger.info(`[Notification] ${title}: ${body}`);
-            }
-        }
-        catch (err) {
-            this.logger.error('Failed to send notification:', err);
-            // Fallback to console
-            this.logger.info(`[Notification] ${title}: ${body}`);
-        }
-    }
-    /**
-     * Sends notification on macOS using osascript (NON-BLOCKING)
-     *
-     * CRITICAL: Fire-and-forget pattern to prevent blocking Claude Code!
-     * Notifications are informational only and should NEVER block execution.
-     */
-    async sendMacOSNotification(title, body, sound) {
-        const soundParam = sound ? ` sound name "${sound}"` : '';
-        const script = `display notification "${this.escapeForAppleScript(body)}" with title "${this.escapeForAppleScript(title)}"${soundParam}`;
-        // Fire-and-forget: DON'T wait for completion!
-        exec(`osascript -e '${script}'`, (error) => {
-            if (error) {
-                this.logger.debug(`Notification failed (non-critical): ${error.message}`);
-            }
-        });
-        // Resolve immediately without waiting
-        return Promise.resolve();
-    }
-    /**
-     * Sends notification on Linux using notify-send (NON-BLOCKING)
-     *
-     * CRITICAL: Fire-and-forget pattern to prevent blocking Claude Code!
-     * Notifications are informational only and should NEVER block execution.
-     */
-    async sendLinuxNotification(title, body) {
-        // Fire-and-forget: DON'T wait for completion!
-        exec('command -v notify-send', (error) => {
-            if (error) {
-                this.logger.debug('notify-send not available, skipping notification');
-                return;
-            }
-            // Fire-and-forget: nested exec also non-blocking
-            exec(`notify-send "${this.escapeForShell(title)}" "${this.escapeForShell(body)}" --urgency=normal`, (error) => {
-                if (error) {
-                    this.logger.debug(`Notification failed (non-critical): ${error.message}`);
-                }
-            });
-        });
-        // Resolve immediately without waiting
-        return Promise.resolve();
-    }
-    /**
-     * Sends notification on Windows using PowerShell toast (NON-BLOCKING)
-     *
-     * CRITICAL: Fire-and-forget pattern to prevent blocking Claude Code!
-     * Notifications are informational only and should NEVER block execution.
-     */
-    async sendWindowsNotification(title, body) {
-        const script = `
-      [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
-      [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] | Out-Null
-
-      $template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)
-      $toastXml = [xml] $template.GetXml()
-      $toastXml.GetElementsByTagName("text")[0].AppendChild($toastXml.CreateTextNode("${this.escapeForPowerShell(title)}")) | Out-Null
-      $toastXml.GetElementsByTagName("text")[1].AppendChild($toastXml.CreateTextNode("${this.escapeForPowerShell(body)}")) | Out-Null
-
-      $xml = New-Object Windows.Data.Xml.Dom.XmlDocument
-      $xml.LoadXml($toastXml.OuterXml)
-      $toast = [Windows.UI.Notifications.ToastNotification]::new($xml)
-      [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("SpecWeave").Show($toast)
-    `;
-        // Fire-and-forget: DON'T wait for completion!
-        exec(`powershell -Command "${script}"`, (error) => {
-            if (error) {
-                this.logger.debug(`Notification failed (non-critical): ${error.message}`);
-            }
-        });
-        // Resolve immediately without waiting
-        return Promise.resolve();
-    }
-    /**
-     * Escapes string for AppleScript
-     * Security: Handles backslashes first, then quotes, then newlines
-     */
-    escapeForAppleScript(str) {
-        return str
-            .replace(/\\/g, '\\\\') // Escape backslashes first
-            .replace(/"/g, '\\"') // Escape double quotes
-            .replace(/\n/g, '\\n') // Escape newlines
-            .replace(/\r/g, '\\r'); // Escape carriage returns
-    }
-    /**
-     * Escapes string for shell (notify-send on Linux)
-     * Security: Comprehensive escaping for shell metacharacters
-     */
-    escapeForShell(str) {
-        return str
-            .replace(/\\/g, '\\\\') // Escape backslashes first
-            .replace(/"/g, '\\"') // Escape double quotes
-            .replace(/\$/g, '\\$') // Escape dollar signs
-            .replace(/`/g, '\\`') // Escape backticks
-            .replace(/!/g, '\\!') // Escape history expansion
-            .replace(/\n/g, ' ') // Replace newlines with spaces
-            .replace(/\r/g, ''); // Remove carriage returns
-    }
-    /**
-     * Escapes string for PowerShell
-     * Security: Comprehensive escaping for PowerShell special chars
-     */
-    escapeForPowerShell(str) {
-        return str
-            .replace(/`/g, '``') // Escape backticks first (PowerShell escape char)
-            .replace(/"/g, '`"') // Escape double quotes
-            .replace(/\$/g, '`$') // Escape dollar signs
-            .replace(/\n/g, '`n') // Escape newlines
-            .replace(/\r/g, '`r'); // Escape carriage returns
-    }
-    /**
-     * Sends a standardized notification using the notification-constants module.
-     *
-     * PREFERRED METHOD - ensures consistent, explicit notifications that follow
-     * the WHO/WHAT/ACTION pattern documented in CLAUDE.md Rule 11.
-     *
-     * @param type - Notification type (cleanup, job_complete, error, etc.)
-     * @param context - Context for message interpolation (count, items, reason, etc.)
-     *
-     * @example
-     * // Send cleanup completion notification
-     * await manager.sendStandardNotification('cleanup', { count: 5 });
-     * // Result: "SpecWeave: Cleanup Done" - "Cleaned up 5 zombie processes. No action needed."
-     *
-     * @example
-     * // Send job completion notification
-     * await manager.sendStandardNotification('job_complete', { jobType: 'Import', items: 12 });
-     * // Result: "SpecWeave: Job Complete" - "Import job finished. Processed 12 items."
-     */
-    async sendStandardNotification(type, context = {}) {
-        const title = getTitleForType(type);
-        const body = buildNotificationMessage(type, context);
-        const sound = getSoundForType(type);
-        return this.sendNotification(title, body, sound);
-    }
-}
-//# sourceMappingURL=notification-manager.js.map

package/dist/src/utils/notification-manager.js.map

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

package/dist/src/utils/package-json-cache.d.ts

@@ -1,162 +0,0 @@
-/**
- * Package.json Cache - Performance optimization for package.json reads
- *
- * Provides a caching layer for package.json reads to avoid redundant file I/O
- * during codebase analysis operations like repo scanning and discovery.
- *
- * Part of increment 0168: Code Review Fixes
- *
- * @module utils/package-json-cache
- * @since v0.34.0
- */
-/**
- * Parsed package.json content
- */
-export interface PackageJsonContent {
-    name?: string;
-    version?: string;
-    main?: string;
-    exports?: Record<string, unknown>;
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    peerDependencies?: Record<string, string>;
-    scripts?: Record<string, string>;
-    [key: string]: unknown;
-}
-/**
- * Cache options
- */
-export interface PackageJsonCacheOptions {
-    /** Maximum number of entries to cache (default: 1000) */
-    maxEntries?: number;
-    /** Time-to-live in milliseconds (default: 60000 = 1 minute) */
-    ttl?: number;
-    /** Whether to validate cache entries by mtime (default: true) */
-    validateMtime?: boolean;
-}
-/**
- * Statistics for cache performance monitoring
- */
-export interface CacheStats {
-    hits: number;
-    misses: number;
-    invalidations: number;
-    size: number;
-}
-/**
- * Package.json Cache - Singleton pattern for shared caching
- *
- * Usage:
- * ```typescript
- * const cache = PackageJsonCache.getInstance();
- * const pkg = cache.get('/path/to/project');
- * if (pkg) {
- *   const deps = cache.getAllDependencies(pkg);
- * }
- * ```
- */
-export declare class PackageJsonCache {
-    private static instance;
-    private cache;
-    private stats;
-    private options;
-    private constructor();
-    /**
-     * Get the singleton instance
-     */
-    static getInstance(options?: PackageJsonCacheOptions): PackageJsonCache;
-    /**
-     * Reset the singleton instance (useful for testing)
-     */
-    static resetInstance(): void;
-    /**
-     * Get package.json content for a project path
-     *
-     * @param projectPath - Path to the project directory (not the package.json file)
-     * @returns Parsed package.json content or null if not found/invalid
-     */
-    get(projectPath: string): PackageJsonContent | null;
-    /**
-     * Check if a package.json exists at the given path
-     *
-     * @param projectPath - Path to the project directory
-     * @returns true if package.json exists
-     */
-    exists(projectPath: string): boolean;
-    /**
-     * Get all dependencies (dependencies + devDependencies + peerDependencies)
-     *
-     * @param pkg - Package.json content
-     * @returns Combined dependencies object
-     */
-    getAllDependencies(pkg: PackageJsonContent): Record<string, string>;
-    /**
-     * Get production dependencies only
-     *
-     * @param pkg - Package.json content
-     * @returns Production dependencies
-     */
-    getProductionDependencies(pkg: PackageJsonContent): Record<string, string>;
-    /**
-     * Check if a dependency exists
-     *
-     * @param pkg - Package.json content
-     * @param depName - Dependency name to check
-     * @returns true if dependency exists in any dependency type
-     */
-    hasDependency(pkg: PackageJsonContent, depName: string): boolean;
-    /**
-     * Invalidate cache for a specific path
-     *
-     * @param projectPath - Path to invalidate
-     */
-    invalidate(projectPath: string): void;
-    /**
-     * Clear the entire cache
-     */
-    clear(): void;
-    /**
-     * Get cache statistics
-     */
-    getStats(): CacheStats;
-    /**
-     * Pre-warm cache with multiple paths (useful for batch operations)
-     *
-     * @param projectPaths - Array of project paths to pre-load
-     */
-    preWarm(projectPaths: string[]): void;
-    /**
-     * Check if a cache entry is still valid
-     */
-    private isValid;
-    /**
-     * Read package.json and cache the result
-     */
-    private readAndCache;
-    /**
-     * Evict oldest entries when cache is full
-     */
-    private evictOldest;
-}
-/**
- * Convenience function for one-off reads (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns Parsed package.json content or null
- */
-export declare function readPackageJson(projectPath: string): PackageJsonContent | null;
-/**
- * Convenience function for checking package.json existence (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns true if package.json exists
- */
-export declare function packageJsonExists(projectPath: string): boolean;
-/**
- * Convenience function for getting all dependencies (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns Combined dependencies or empty object if not found
- */
-export declare function getAllDependencies(projectPath: string): Record<string, string>;
-//# sourceMappingURL=package-json-cache.d.ts.map

package/dist/src/utils/package-json-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-json-cache.d.ts","sourceRoot":"","sources":["../../../src/utils/package-json-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAWD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,KAAK,CAAiE;IAC9E,OAAO,CAAC,OAAO,CAAoC;IAEnD,OAAO;IAQP;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,gBAAgB;IAOvE;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAiBnD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAapC;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQnE;;;;;OAKG;IACH,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAM1E;;;;;;OAMG;IACH,aAAa,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAKhE;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;;;OAIG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,OAAO,CAAC,OAAO;IAwBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9E"}

package/dist/src/utils/package-json-cache.js

@@ -1,257 +0,0 @@
-/**
- * Package.json Cache - Performance optimization for package.json reads
- *
- * Provides a caching layer for package.json reads to avoid redundant file I/O
- * during codebase analysis operations like repo scanning and discovery.
- *
- * Part of increment 0168: Code Review Fixes
- *
- * @module utils/package-json-cache
- * @since v0.34.0
- */
-import * as fs from 'fs';
-import * as path from 'path';
-/**
- * Package.json Cache - Singleton pattern for shared caching
- *
- * Usage:
- * ```typescript
- * const cache = PackageJsonCache.getInstance();
- * const pkg = cache.get('/path/to/project');
- * if (pkg) {
- *   const deps = cache.getAllDependencies(pkg);
- * }
- * ```
- */
-export class PackageJsonCache {
-    constructor(options = {}) {
-        this.cache = new Map();
-        this.stats = { hits: 0, misses: 0, invalidations: 0, size: 0 };
-        this.options = {
-            maxEntries: options.maxEntries ?? 1000,
-            ttl: options.ttl ?? 60000,
-            validateMtime: options.validateMtime ?? true,
-        };
-    }
-    /**
-     * Get the singleton instance
-     */
-    static getInstance(options) {
-        if (!PackageJsonCache.instance) {
-            PackageJsonCache.instance = new PackageJsonCache(options);
-        }
-        return PackageJsonCache.instance;
-    }
-    /**
-     * Reset the singleton instance (useful for testing)
-     */
-    static resetInstance() {
-        PackageJsonCache.instance = null;
-    }
-    /**
-     * Get package.json content for a project path
-     *
-     * @param projectPath - Path to the project directory (not the package.json file)
-     * @returns Parsed package.json content or null if not found/invalid
-     */
-    get(projectPath) {
-        const normalizedPath = path.resolve(projectPath);
-        const packageJsonPath = path.join(normalizedPath, 'package.json');
-        // Check cache first
-        const cached = this.cache.get(normalizedPath);
-        if (cached && this.isValid(cached, packageJsonPath)) {
-            this.stats.hits++;
-            return cached.content;
-        }
-        // Cache miss - read and cache
-        this.stats.misses++;
-        const entry = this.readAndCache(normalizedPath, packageJsonPath);
-        return entry.content;
-    }
-    /**
-     * Check if a package.json exists at the given path
-     *
-     * @param projectPath - Path to the project directory
-     * @returns true if package.json exists
-     */
-    exists(projectPath) {
-        const normalizedPath = path.resolve(projectPath);
-        const packageJsonPath = path.join(normalizedPath, 'package.json');
-        // Check cache first
-        const cached = this.cache.get(normalizedPath);
-        if (cached && this.isValid(cached, packageJsonPath)) {
-            return cached.content !== null;
-        }
-        return fs.existsSync(packageJsonPath);
-    }
-    /**
-     * Get all dependencies (dependencies + devDependencies + peerDependencies)
-     *
-     * @param pkg - Package.json content
-     * @returns Combined dependencies object
-     */
-    getAllDependencies(pkg) {
-        return {
-            ...(pkg.dependencies || {}),
-            ...(pkg.devDependencies || {}),
-            ...(pkg.peerDependencies || {}),
-        };
-    }
-    /**
-     * Get production dependencies only
-     *
-     * @param pkg - Package.json content
-     * @returns Production dependencies
-     */
-    getProductionDependencies(pkg) {
-        return {
-            ...(pkg.dependencies || {}),
-        };
-    }
-    /**
-     * Check if a dependency exists
-     *
-     * @param pkg - Package.json content
-     * @param depName - Dependency name to check
-     * @returns true if dependency exists in any dependency type
-     */
-    hasDependency(pkg, depName) {
-        const allDeps = this.getAllDependencies(pkg);
-        return depName in allDeps;
-    }
-    /**
-     * Invalidate cache for a specific path
-     *
-     * @param projectPath - Path to invalidate
-     */
-    invalidate(projectPath) {
-        const normalizedPath = path.resolve(projectPath);
-        if (this.cache.delete(normalizedPath)) {
-            this.stats.invalidations++;
-            this.stats.size = this.cache.size;
-        }
-    }
-    /**
-     * Clear the entire cache
-     */
-    clear() {
-        this.cache.clear();
-        this.stats.size = 0;
-    }
-    /**
-     * Get cache statistics
-     */
-    getStats() {
-        return { ...this.stats };
-    }
-    /**
-     * Pre-warm cache with multiple paths (useful for batch operations)
-     *
-     * @param projectPaths - Array of project paths to pre-load
-     */
-    preWarm(projectPaths) {
-        for (const projectPath of projectPaths) {
-            this.get(projectPath);
-        }
-    }
-    /**
-     * Check if a cache entry is still valid
-     */
-    isValid(entry, packageJsonPath) {
-        const now = Date.now();
-        // Check TTL
-        if (now - entry.readAt > this.options.ttl) {
-            return false;
-        }
-        // Check mtime if enabled
-        if (this.options.validateMtime) {
-            try {
-                const stat = fs.statSync(packageJsonPath);
-                if (stat.mtimeMs !== entry.mtime) {
-                    return false;
-                }
-            }
-            catch {
-                // File doesn't exist anymore
-                return entry.content === null;
-            }
-        }
-        return true;
-    }
-    /**
-     * Read package.json and cache the result
-     */
-    readAndCache(normalizedPath, packageJsonPath) {
-        // Enforce max entries
-        if (this.cache.size >= this.options.maxEntries) {
-            this.evictOldest();
-        }
-        let content = null;
-        let mtime = 0;
-        try {
-            if (fs.existsSync(packageJsonPath)) {
-                const stat = fs.statSync(packageJsonPath);
-                mtime = stat.mtimeMs;
-                const rawContent = fs.readFileSync(packageJsonPath, 'utf-8');
-                content = JSON.parse(rawContent);
-            }
-        }
-        catch {
-            // Invalid JSON or read error - cache as null
-            content = null;
-        }
-        const entry = {
-            content,
-            mtime,
-            readAt: Date.now(),
-        };
-        this.cache.set(normalizedPath, entry);
-        this.stats.size = this.cache.size;
-        return entry;
-    }
-    /**
-     * Evict oldest entries when cache is full
-     */
-    evictOldest() {
-        // Remove 10% of oldest entries
-        const toRemove = Math.max(1, Math.floor(this.options.maxEntries * 0.1));
-        const entries = Array.from(this.cache.entries())
-            .sort((a, b) => a[1].readAt - b[1].readAt)
-            .slice(0, toRemove);
-        for (const [key] of entries) {
-            this.cache.delete(key);
-        }
-        this.stats.size = this.cache.size;
-    }
-}
-PackageJsonCache.instance = null;
-/**
- * Convenience function for one-off reads (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns Parsed package.json content or null
- */
-export function readPackageJson(projectPath) {
-    return PackageJsonCache.getInstance().get(projectPath);
-}
-/**
- * Convenience function for checking package.json existence (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns true if package.json exists
- */
-export function packageJsonExists(projectPath) {
-    return PackageJsonCache.getInstance().exists(projectPath);
-}
-/**
- * Convenience function for getting all dependencies (uses singleton)
- *
- * @param projectPath - Path to the project directory
- * @returns Combined dependencies or empty object if not found
- */
-export function getAllDependencies(projectPath) {
-    const cache = PackageJsonCache.getInstance();
-    const pkg = cache.get(projectPath);
-    return pkg ? cache.getAllDependencies(pkg) : {};
-}
-//# sourceMappingURL=package-json-cache.js.map

package/dist/src/utils/package-json-cache.js.map

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