opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/cleanup-empty-parents.js

@@ -0,0 +1,56 @@
+import path from 'path';
+import { readdir } from 'fs/promises';
+import { remove } from './fs.js';
+import { logger } from './logger.js';
+/**
+ * Clean up empty parent directories after file deletion.
+ *
+ * Walks up the directory tree from each deleted file, removing empty directories
+ * until hitting a preserved directory or the root.
+ *
+ * For platform files (e.g., .cursor/commands/essentials/file.md):
+ * - Removes empty subdirectories (essentials/, commands/)
+ * - Stops at and preserves the platform root (.cursor/)
+ *
+ * For root files (e.g., docs/guides/file.md):
+ * - Removes all empty parent directories
+ * - Stops only at workspace root
+ *
+ * @param rootDir - Root directory boundary (workspace root or package root)
+ * @param deletedPaths - Absolute paths of deleted files
+ * @param preservedDirs - Set of absolute directory paths to preserve (never remove)
+ */
+export async function cleanupEmptyParents(rootDir, deletedPaths, preservedDirs = new Set()) {
+    const candidateDirs = new Set();
+    // Collect all parent directories from deleted files
+    for (const deletedPath of deletedPaths) {
+        let current = path.dirname(deletedPath);
+        // Walk up the directory tree
+        while (current.startsWith(rootDir) && current !== rootDir) {
+            // Stop at preserved directories (platform roots)
+            if (preservedDirs.has(current)) {
+                break;
+            }
+            candidateDirs.add(current);
+            current = path.dirname(current);
+        }
+    }
+    // Sort by depth (deepest first) to ensure we process child directories before parents
+    const sorted = Array.from(candidateDirs).sort((a, b) => b.length - a.length);
+    // Remove empty directories
+    for (const dir of sorted) {
+        try {
+            const entries = await readdir(dir);
+            // Only remove if directory is empty and not preserved
+            if (entries.length === 0 && !preservedDirs.has(dir)) {
+                await remove(dir);
+                logger.debug(`Removed empty directory: ${path.relative(rootDir, dir)}`);
+            }
+        }
+        catch (error) {
+            // Ignore errors (directory may not exist, permission issues, etc.)
+            logger.debug(`Could not process directory ${dir}: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=cleanup-empty-parents.js.map

package/packages/core/dist/utils/cleanup-empty-parents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-empty-parents.js","sourceRoot":"","sources":["../../src/utils/cleanup-empty-parents.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,YAAsB,EACtB,gBAA6B,IAAI,GAAG,EAAE;IAEtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,oDAAoD;IACpD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAExC,6BAA6B;QAC7B,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC1D,iDAAiD;YACjD,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM;YACR,CAAC;YAED,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAE7E,2BAA2B;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAEnC,sDAAsD;YACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mEAAmE;YACnE,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC"}

package/packages/core/dist/utils/custom-path-resolution.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Utilities for custom path resolution and validation
+ *
+ * Handles user-specified custom paths for package creation,
+ * including validation, normalization, and error reporting.
+ */
+/**
+ * Result of custom path resolution
+ */
+export interface ResolvedCustomPath {
+    /** The original path as provided by the user */
+    original: string;
+    /** The resolved absolute path */
+    absolute: string;
+    /** The parent directory of the resolved path */
+    parentDir: string;
+    /** Path to openpackage.yml that will be created */
+    packageYmlPath: string;
+}
+/**
+ * Validation result for custom path
+ */
+export interface CustomPathValidation {
+    /** Whether the path is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+    /** Warning message (path is valid but has concerns) */
+    warning?: string;
+}
+/**
+ * Resolve a custom path to an absolute path
+ *
+ * Handles:
+ * - Relative paths (resolved from cwd)
+ * - Absolute paths (used as-is)
+ * - Tilde paths (expanded to home directory)
+ *
+ * @param customPath - The custom path provided by user
+ * @param cwd - Current working directory for relative path resolution
+ * @returns Resolved path information
+ */
+export declare function resolveCustomPath(customPath: string, cwd: string): ResolvedCustomPath;
+/**
+ * Validate a custom path for package creation
+ *
+ * Checks:
+ * - Path is not empty
+ * - Parent directory exists or can be created
+ * - Path doesn't conflict with critical system paths
+ * - Path has reasonable structure
+ *
+ * @param resolved - Resolved custom path information
+ * @param force - Whether --force flag is set
+ * @returns Validation result
+ */
+export declare function validateCustomPath(resolved: ResolvedCustomPath, force?: boolean): Promise<CustomPathValidation>;
+/**
+ * Format a custom path for display to the user
+ *
+ * Shows relative path if it's shorter and clearer,
+ * otherwise shows absolute path with tilde expansion for home directory.
+ *
+ * @param resolved - Resolved custom path information
+ * @param cwd - Current working directory for relative path display
+ * @returns Formatted path for display
+ */
+export declare function formatCustomPathForDisplay(resolved: ResolvedCustomPath, cwd: string): string;
+//# sourceMappingURL=custom-path-resolution.d.ts.map

package/packages/core/dist/utils/custom-path-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-path-resolution.d.ts","sourceRoot":"","sources":["../../src/utils/custom-path-resolution.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAiBpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAmE/B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,EAAE,MAAM,GACV,MAAM,CAUR"}

package/packages/core/dist/utils/custom-path-resolution.js

@@ -0,0 +1,160 @@
+import { resolve, isAbsolute, dirname, join } from 'path';
+import { exists, isDirectory } from './fs.js';
+import { expandTildePath } from './path-resolution.js';
+/**
+ * Resolve a custom path to an absolute path
+ *
+ * Handles:
+ * - Relative paths (resolved from cwd)
+ * - Absolute paths (used as-is)
+ * - Tilde paths (expanded to home directory)
+ *
+ * @param customPath - The custom path provided by user
+ * @param cwd - Current working directory for relative path resolution
+ * @returns Resolved path information
+ */
+export function resolveCustomPath(customPath, cwd) {
+    // Expand tilde if present
+    const expandedPath = customPath.startsWith('~')
+        ? expandTildePath(customPath)
+        : customPath;
+    // Resolve to absolute path
+    const absolutePath = isAbsolute(expandedPath)
+        ? resolve(expandedPath)
+        : resolve(cwd, expandedPath);
+    return {
+        original: customPath,
+        absolute: absolutePath,
+        parentDir: dirname(absolutePath),
+        packageYmlPath: join(absolutePath, 'openpackage.yml')
+    };
+}
+/**
+ * Validate a custom path for package creation
+ *
+ * Checks:
+ * - Path is not empty
+ * - Parent directory exists or can be created
+ * - Path doesn't conflict with critical system paths
+ * - Path has reasonable structure
+ *
+ * @param resolved - Resolved custom path information
+ * @param force - Whether --force flag is set
+ * @returns Validation result
+ */
+export async function validateCustomPath(resolved, force = false) {
+    const { original, absolute, parentDir, packageYmlPath } = resolved;
+    // Check for empty path
+    if (!original || original.trim() === '') {
+        return {
+            valid: false,
+            error: 'Path cannot be empty'
+        };
+    }
+    // Check for dangerous paths
+    const dangerousPathCheck = checkDangerousPath(absolute);
+    if (!dangerousPathCheck.valid) {
+        return dangerousPathCheck;
+    }
+    // Check if parent directory exists
+    const parentExists = await exists(parentDir);
+    if (!parentExists) {
+        return {
+            valid: false,
+            error: `Parent directory does not exist: ${parentDir}\n` +
+                `Please create it first or choose a different path.`
+        };
+    }
+    // Check if parent is actually a directory
+    const parentIsDir = await isDirectory(parentDir);
+    if (!parentIsDir) {
+        return {
+            valid: false,
+            error: `Parent path exists but is not a directory: ${parentDir}`
+        };
+    }
+    // Check if package directory already exists
+    const targetExists = await exists(absolute);
+    if (targetExists) {
+        const targetIsDir = await isDirectory(absolute);
+        if (!targetIsDir) {
+            return {
+                valid: false,
+                error: `Path exists but is not a directory: ${absolute}`
+            };
+        }
+        // Check if openpackage.yml already exists
+        const ymlExists = await exists(packageYmlPath);
+        if (ymlExists && !force) {
+            return {
+                valid: false,
+                error: `Package already exists at: ${absolute}\n` +
+                    `Use --force to overwrite.`
+            };
+        }
+        // Directory exists, will be used or overwritten
+        if (ymlExists && force) {
+            return {
+                valid: true,
+                warning: `Overwriting existing package at: ${absolute}`
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Check if a path is dangerous or conflicts with critical system paths
+ *
+ * @param absolutePath - The absolute path to check
+ * @returns Validation result
+ */
+function checkDangerousPath(absolutePath) {
+    const normalizedPath = absolutePath.toLowerCase();
+    // Don't allow root directory
+    if (absolutePath === '/' || /^[A-Z]:\\?$/.test(absolutePath)) {
+        return {
+            valid: false,
+            error: 'Cannot create package in root directory'
+        };
+    }
+    // Don't allow critical system directories
+    // Note: We allow temp directories like /tmp and /var/folders (macOS temp)
+    const dangerousPaths = [
+        '/bin', '/sbin', '/usr', '/etc', '/sys', '/proc', '/dev',
+        '/boot', '/lib', '/lib64', '/opt', '/root', '/srv',
+        'c:\\windows', 'c:\\program files', 'c:\\program files (x86)'
+    ];
+    for (const dangerous of dangerousPaths) {
+        if (normalizedPath === dangerous || normalizedPath.startsWith(dangerous + '/')) {
+            // Exception: Allow macOS temp directories in /var/folders
+            if (dangerous === '/var' && normalizedPath.includes('/var/folders/')) {
+                continue;
+            }
+            return {
+                valid: false,
+                error: `Cannot create package in system directory: ${absolutePath}`
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Format a custom path for display to the user
+ *
+ * Shows relative path if it's shorter and clearer,
+ * otherwise shows absolute path with tilde expansion for home directory.
+ *
+ * @param resolved - Resolved custom path information
+ * @param cwd - Current working directory for relative path display
+ * @returns Formatted path for display
+ */
+export function formatCustomPathForDisplay(resolved, cwd) {
+    const { original, absolute } = resolved;
+    // If original was relative or tilde, prefer showing that
+    if (!isAbsolute(original)) {
+        return original;
+    }
+    // Otherwise show absolute with potential tilde
+    return absolute;
+}
+//# sourceMappingURL=custom-path-resolution.js.map

package/packages/core/dist/utils/custom-path-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-path-resolution.js","sourceRoot":"","sources":["../../src/utils/custom-path-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAwCvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,GAAW;IAEX,0BAA0B;IAC1B,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAC7C,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC;QAC7B,CAAC,CAAC,UAAU,CAAC;IAEf,2BAA2B;IAC3B,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QACvB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE/B,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;QAChC,cAAc,EAAE,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAA4B,EAC5B,QAAiB,KAAK;IAEtB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;IAEnE,uBAAuB;IACvB,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,sBAAsB;SAC9B,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,oCAAoC,SAAS,IAAI;gBACjD,oDAAoD;SAC5D,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8CAA8C,SAAS,EAAE;SACjE,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,uCAAuC,QAAQ,EAAE;aACzD,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,8BAA8B,QAAQ,IAAI;oBAC1C,2BAA2B;aACnC,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACvB,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,oCAAoC,QAAQ,EAAE;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAElD,6BAA6B;IAC7B,IAAI,YAAY,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,yCAAyC;SACjD,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,0EAA0E;IAC1E,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;QACxD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;QAClD,aAAa,EAAE,mBAAmB,EAAE,yBAAyB;KAC9D,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;QACvC,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/E,0DAA0D;YAC1D,IAAI,SAAS,KAAK,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBACrE,SAAS;YACX,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,8CAA8C,YAAY,EAAE;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAA4B,EAC5B,GAAW;IAEX,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAExC,yDAAyD;IACzD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/packages/core/dist/utils/entity-detector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Entity Type Detection Utilities
+ *
+ * Determines whether a path represents a package, workspace, or generic resource.
+ */
+/**
+ * Entity type classification
+ */
+export type EntityType = 'workspace' | 'package' | 'resource';
+/**
+ * Detect the type of entity at a given path.
+ *
+ * Detection logic:
+ * - workspace: Has .openpackage/openpackage.yml
+ * - package: Has openpackage.yml, or has Claude plugin characteristics, or has standard package directories
+ * - resource: Everything else (individual files, subdirectories without package markers)
+ *
+ * @param path - Absolute path to check
+ * @returns Entity type
+ */
+export declare function detectEntityType(path: string): Promise<EntityType>;
+/**
+ * Get the display name for an entity.
+ *
+ * For packages: reads name from openpackage.yml, falls back to directory name
+ * For other types: uses the provided name
+ *
+ * @param path - Absolute path to the entity
+ * @param fallbackName - Name to use if package name cannot be determined
+ * @returns Display name
+ */
+export declare function getEntityDisplayName(path: string, fallbackName: string): Promise<string>;
+//# sourceMappingURL=entity-detector.d.ts.map

package/packages/core/dist/utils/entity-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-detector.d.ts","sourceRoot":"","sources":["../../src/utils/entity-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BxE;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/packages/core/dist/utils/entity-detector.js

@@ -0,0 +1,78 @@
+/**
+ * Entity Type Detection Utilities
+ *
+ * Determines whether a path represents a package, workspace, or generic resource.
+ */
+import { join } from 'path';
+import { exists, isDirectory } from './fs.js';
+/**
+ * Detect the type of entity at a given path.
+ *
+ * Detection logic:
+ * - workspace: Has .openpackage/openpackage.yml
+ * - package: Has openpackage.yml, or has Claude plugin characteristics, or has standard package directories
+ * - resource: Everything else (individual files, subdirectories without package markers)
+ *
+ * @param path - Absolute path to check
+ * @returns Entity type
+ */
+export async function detectEntityType(path) {
+    // Check for workspace marker (.openpackage/openpackage.yml)
+    const workspaceMarker = join(path, '.openpackage', 'openpackage.yml');
+    if (await exists(workspaceMarker)) {
+        return 'workspace';
+    }
+    // Check for package marker (openpackage.yml at root)
+    const packageMarker = join(path, 'openpackage.yml');
+    if (await exists(packageMarker)) {
+        return 'package';
+    }
+    // Check for Claude plugin characteristics (.claude-plugin/plugin.json)
+    const claudePluginMarker = join(path, '.claude-plugin', 'plugin.json');
+    if (await exists(claudePluginMarker)) {
+        return 'package';
+    }
+    // Check for standard package directories (agents/, skills/, commands/, rules/, hooks/)
+    const packageDirs = ['agents', 'skills', 'commands', 'rules', 'hooks'];
+    for (const dir of packageDirs) {
+        const dirPath = join(path, dir);
+        if (await exists(dirPath) && await isDirectory(dirPath)) {
+            return 'package';
+        }
+    }
+    // Default to resource for everything else
+    return 'resource';
+}
+/**
+ * Get the display name for an entity.
+ *
+ * For packages: reads name from openpackage.yml, falls back to directory name
+ * For other types: uses the provided name
+ *
+ * @param path - Absolute path to the entity
+ * @param fallbackName - Name to use if package name cannot be determined
+ * @returns Display name
+ */
+export async function getEntityDisplayName(path, fallbackName) {
+    const entityType = await detectEntityType(path);
+    // For packages and workspaces, try to read the name from openpackage.yml
+    if (entityType === 'package' || entityType === 'workspace') {
+        try {
+            const { parsePackageYml } = await import('./package-yml.js');
+            const manifestPath = entityType === 'workspace'
+                ? join(path, '.openpackage', 'openpackage.yml')
+                : join(path, 'openpackage.yml');
+            if (await exists(manifestPath)) {
+                const manifest = await parsePackageYml(manifestPath);
+                if (manifest.name) {
+                    return manifest.name;
+                }
+            }
+        }
+        catch (error) {
+            // Fall through to use fallback name
+        }
+    }
+    return fallbackName;
+}
+//# sourceMappingURL=entity-detector.js.map

package/packages/core/dist/utils/entity-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-detector.js","sourceRoot":"","sources":["../../src/utils/entity-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,4DAA4D;IAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,qDAAqD;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACpD,IAAI,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uEAAuE;IACvE,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACvE,IAAI,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uFAAuF;IACvF,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,YAAoB;IAEpB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEhD,yEAAyE;IACzE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAC7D,MAAM,YAAY,GAAG,UAAU,KAAK,WAAW;gBAC7C,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,iBAAiB,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAElC,IAAI,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;gBACrD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAClB,OAAO,QAAQ,CAAC,IAAI,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/packages/core/dist/utils/error-reasons.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extract a concise, user-friendly reason string from a raw error message.
+ *
+ * This is used to normalize low-level network / registry / fetch errors into
+ * short labels that can be embedded in messages like:
+ *   "Remote pull failed for `<pkg>` (reason: <reason>)"
+ */
+export declare function extractRemoteErrorReason(message: string): string;
+//# sourceMappingURL=error-reasons.d.ts.map

package/packages/core/dist/utils/error-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reasons.d.ts","sourceRoot":"","sources":["../../src/utils/error-reasons.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkDhE"}

package/packages/core/dist/utils/error-reasons.js

@@ -0,0 +1,51 @@
+/**
+ * Extract a concise, user-friendly reason string from a raw error message.
+ *
+ * This is used to normalize low-level network / registry / fetch errors into
+ * short labels that can be embedded in messages like:
+ *   "Remote pull failed for `<pkg>` (reason: <reason>)"
+ */
+export function extractRemoteErrorReason(message) {
+    const normalized = (message || '').trim();
+    if (!normalized) {
+        return 'unknown error';
+    }
+    // Specific phrases we already emit elsewhere
+    if (normalized.includes('not found in remote registry')) {
+        return 'not found in remote registry';
+    }
+    if (/Access denied/i.test(normalized)) {
+        return 'access denied';
+    }
+    if (/Network error/i.test(normalized)) {
+        return 'network error';
+    }
+    if (/Integrity check failed/i.test(normalized)) {
+        return 'integrity check failed';
+    }
+    // Common network / fetch failures
+    if (/fetch failed/i.test(normalized)) {
+        return 'network error';
+    }
+    if (/network|ENOTFOUND|ECONNREFUSED|ETIMEDOUT/i.test(normalized)) {
+        return 'network error';
+    }
+    // Not found / HTTP 404 style errors
+    if (/not found|404/i.test(normalized)) {
+        return 'not found in remote registry';
+    }
+    // Access / auth errors
+    if (/access denied|unauthorized|403|401/i.test(normalized)) {
+        return 'access denied';
+    }
+    // Integrity / checksum issues
+    if (/integrity|checksum/i.test(normalized)) {
+        return 'integrity check failed';
+    }
+    // Fallback: return message if short enough, otherwise truncate
+    if (normalized.length <= 50) {
+        return normalized;
+    }
+    return `${normalized.slice(0, 47)}...`;
+}
+//# sourceMappingURL=error-reasons.js.map

package/packages/core/dist/utils/error-reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reasons.js","sourceRoot":"","sources":["../../src/utils/error-reasons.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;QACxD,OAAO,8BAA8B,CAAC;IACxC,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,kCAAkC;IAClC,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,2CAA2C,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,oCAAoC;IACpC,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,8BAA8B,CAAC;IACxC,CAAC;IAED,uBAAuB;IACvB,IAAI,qCAAqC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,8BAA8B;IAC9B,IAAI,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,+DAA+D;IAC/D,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC;AACzC,CAAC"}

package/packages/core/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+import { OpenPackageError, CommandResult } from '../types/index.js';
+/**
+ * Custom error classes for different types of errors in the OpenPackage CLI
+ */
+export declare class PackageNotFoundError extends OpenPackageError {
+    constructor(packageName: string);
+}
+export declare class VersionConflictError extends OpenPackageError {
+    constructor(packageName: string, details: {
+        ranges: string[];
+        parents?: string[];
+        availableVersions?: string[];
+    });
+}
+export declare class InvalidPackageError extends OpenPackageError {
+    constructor(reason: string, details?: any);
+}
+export declare class FileSystemError extends OpenPackageError {
+    constructor(message: string, details?: any);
+}
+export declare class ValidationError extends OpenPackageError {
+    constructor(message: string, details?: any);
+}
+export declare class ConfigError extends OpenPackageError {
+    constructor(message: string, details?: any);
+}
+export declare class UserCancellationError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Error handler function that provides consistent error handling.
+ * Returns a CommandResult rather than performing any IO -- callers
+ * decide how to present or act on the result.
+ */
+export declare function handleError(error: unknown): CommandResult;
+//# sourceMappingURL=errors.d.ts.map

package/packages/core/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhF;;GAEG;AAEH,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,WAAW,EAAE,MAAM;CAGhC;AAED,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAEtD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B;CAMJ;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG1C;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3C;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3C;AAED,qBAAa,WAAY,SAAQ,gBAAgB;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,GAAE,MAAsC;CAI5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAqBzD"}

package/packages/core/dist/utils/errors.js

@@ -0,0 +1,73 @@
+import { OpenPackageError, ErrorCodes } from '../types/index.js';
+import { logger } from './logger.js';
+/**
+ * Custom error classes for different types of errors in the OpenPackage CLI
+ */
+export class PackageNotFoundError extends OpenPackageError {
+    constructor(packageName) {
+        super(`Package '${packageName}' not found`, ErrorCodes.PACKAGE_NOT_FOUND, { packageName });
+    }
+}
+export class VersionConflictError extends OpenPackageError {
+    constructor(packageName, details) {
+        const msg = `No version of '${packageName}' satisfies ranges: ${details.ranges.join(', ')}${details.availableVersions?.length ? `. Available: ${details.availableVersions.join(', ')}` : ''}`;
+        super(msg, ErrorCodes.VALIDATION_ERROR, { packageName, ...details });
+        this.name = 'VersionConflictError';
+    }
+}
+export class InvalidPackageError extends OpenPackageError {
+    constructor(reason, details) {
+        super(`Invalid package: ${reason}`, ErrorCodes.INVALID_PACKAGE, details);
+    }
+}
+export class FileSystemError extends OpenPackageError {
+    constructor(message, details) {
+        super(`File system error: ${message}`, ErrorCodes.FILE_SYSTEM_ERROR, details);
+    }
+}
+export class ValidationError extends OpenPackageError {
+    constructor(message, details) {
+        super(`Validation error: ${message}`, ErrorCodes.VALIDATION_ERROR, details);
+    }
+}
+export class ConfigError extends OpenPackageError {
+    constructor(message, details) {
+        super(message, ErrorCodes.CONFIG_ERROR, details);
+    }
+}
+export class UserCancellationError extends Error {
+    constructor(message = 'Operation cancelled by user') {
+        super(message);
+        this.name = 'UserCancellationError';
+    }
+}
+/**
+ * Error handler function that provides consistent error handling.
+ * Returns a CommandResult rather than performing any IO -- callers
+ * decide how to present or act on the result.
+ */
+export function handleError(error) {
+    if (error instanceof OpenPackageError) {
+        // For CLI UX, avoid noisy error logs by default; surface details only in verbose mode
+        logger.debug(error.message, { code: error.code, details: error.details });
+        return {
+            success: false,
+            error: error.message
+        };
+    }
+    else if (error instanceof Error) {
+        logger.debug('Unexpected error occurred', { message: error.message, stack: error.stack });
+        return {
+            success: false,
+            error: error.message
+        };
+    }
+    else {
+        logger.debug('Unknown error occurred', { error });
+        return {
+            success: false,
+            error: 'An unknown error occurred'
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/packages/core/dist/utils/errors.js.map

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

package/packages/core/dist/utils/expand-directory-selections.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Directory Selection Expansion Utility
+ *
+ * Expands directory selections (paths ending with '/') into all files within them.
+ * Used by add and remove commands to handle directory selections from interactive file selector.
+ */
+/**
+ * Expand directory selections into individual file paths
+ *
+ * @param selectedPaths - Array of selected paths (files and directories with '/' suffix)
+ * @param basePath - Base directory path for resolving relative paths
+ * @returns Array of individual file paths (no directories)
+ *
+ * @example
+ * const selections = ['src/', 'package.json', 'docs/readme.md'];
+ * const expanded = await expandDirectorySelections(selections, '/workspace');
+ * // Returns: ['src/index.ts', 'src/utils/helper.ts', 'package.json', 'docs/readme.md']
+ */
+export declare function expandDirectorySelections(selectedPaths: string[], basePath: string): Promise<string[]>;
+/**
+ * Check if any selected paths are directories
+ *
+ * @param selectedPaths - Array of selected paths
+ * @returns True if at least one path is a directory (ends with '/')
+ */
+export declare function hasDirectorySelections(selectedPaths: string[]): boolean;
+/**
+ * Count how many directories and files are in the selection
+ *
+ * @param selectedPaths - Array of selected paths
+ * @returns Object with counts of directories and files
+ */
+export declare function countSelectionTypes(selectedPaths: string[]): {
+    dirs: number;
+    files: number;
+};
+//# sourceMappingURL=expand-directory-selections.d.ts.map

package/packages/core/dist/utils/expand-directory-selections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-directory-selections.d.ts","sourceRoot":"","sources":["../../src/utils/expand-directory-selections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa5F"}