opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/file-walker.js

@@ -0,0 +1,144 @@
+/**
+ * File Walker Utility
+ *
+ * Provides efficient file system traversal utilities for walking directory trees.
+ * Used across install, save, status, pack, and other commands.
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+/**
+ * Async generator that walks a directory tree and yields file paths
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ *
+ * @example
+ * for await (const filePath of walkFiles('/path/to/dir')) {
+ *   console.log(filePath);
+ * }
+ */
+export async function* walkFiles(dir, options = {}) {
+    const { filter, followSymlinks = false, maxDepth = Infinity, includeDirs = false } = options;
+    yield* walkFilesInternal(dir, filter, followSymlinks, maxDepth, includeDirs, 0);
+}
+/**
+ * Internal recursive walker
+ */
+async function* walkFilesInternal(dir, filter, followSymlinks, maxDepth, includeDirs, currentDepth) {
+    // Check depth limit
+    if (currentDepth > maxDepth) {
+        return;
+    }
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            // Handle symlinks
+            let isDirectory = entry.isDirectory();
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink() && followSymlinks) {
+                try {
+                    const stat = await fs.stat(fullPath);
+                    isDirectory = stat.isDirectory();
+                    isFile = stat.isFile();
+                }
+                catch {
+                    // Skip broken symlinks
+                    continue;
+                }
+            }
+            else if (entry.isSymbolicLink()) {
+                // Skip symlinks if not following
+                continue;
+            }
+            // Apply filter
+            if (filter) {
+                const shouldInclude = await filter(fullPath, isDirectory);
+                if (!shouldInclude) {
+                    continue;
+                }
+            }
+            // Yield directories if requested
+            if (isDirectory && includeDirs) {
+                yield fullPath;
+            }
+            // Recurse into directories
+            if (isDirectory) {
+                yield* walkFilesInternal(fullPath, filter, followSymlinks, maxDepth, includeDirs, currentDepth + 1);
+            }
+            else if (isFile) {
+                // Yield files
+                yield fullPath;
+            }
+        }
+    }
+    catch (error) {
+        // Ignore permission errors and continue
+        if (error.code !== 'EACCES' &&
+            error.code !== 'EPERM') {
+            throw error;
+        }
+    }
+}
+/**
+ * Walk directory and collect all files into an array
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ * @returns Array of file paths
+ */
+export async function collectFiles(dir, options = {}) {
+    const files = [];
+    for await (const filePath of walkFiles(dir, options)) {
+        files.push(filePath);
+    }
+    return files;
+}
+/**
+ * Walk directory with a simple include/exclude pattern filter
+ *
+ * @param dir - Directory to walk
+ * @param includePatterns - Patterns to include (minimatch)
+ * @param excludePatterns - Patterns to exclude (minimatch)
+ * @returns Async generator of matching file paths
+ */
+export async function* walkWithPatterns(dir, includePatterns = ['**/*'], excludePatterns = []) {
+    const { minimatch } = await import('minimatch');
+    const { relative } = await import('path');
+    const filter = (path, isDirectory) => {
+        // Always traverse directories
+        if (isDirectory) {
+            return true;
+        }
+        const relativePath = relative(dir, path);
+        // Check exclusions first
+        for (const pattern of excludePatterns) {
+            if (minimatch(relativePath, pattern, { dot: true })) {
+                return false;
+            }
+        }
+        // Check inclusions
+        for (const pattern of includePatterns) {
+            if (minimatch(relativePath, pattern, { dot: true })) {
+                return true;
+            }
+        }
+        return false;
+    };
+    yield* walkFiles(dir, { filter });
+}
+/**
+ * Count files in a directory (without collecting them all)
+ *
+ * @param dir - Directory to walk
+ * @param options - Walking options
+ * @returns Number of files
+ */
+export async function countFiles(dir, options = {}) {
+    let count = 0;
+    for await (const _ of walkFiles(dir, options)) {
+        count++;
+    }
+    return count;
+}
+//# sourceMappingURL=file-walker.js.map

package/packages/core/dist/utils/file-walker.js.map

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

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

@@ -0,0 +1,93 @@
+import { PackageYml } from '../types/index.js';
+import type { OutputPort } from '../core/ports/output.js';
+/**
+ * Formatting utilities for consistent display across commands
+ */
+/**
+ * Format a file system path for display to the user.
+ *
+ * This function provides a unified way to display paths across all commands:
+ * - Uses tilde notation (~) for paths under home directory (e.g., ~/.claude/..., ~/.config/..., ~/.openpackage/...)
+ * - Uses relative paths from cwd for paths in the workspace
+ * - Falls back to absolute path for other cases
+ *
+ * @param path - The path to format (can be absolute or relative)
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Formatted path string for display
+ *
+ * @example
+ * formatPathForDisplay('/Users/user/.openpackage/packages/my-pkg') // => '~/.openpackage/packages/my-pkg'
+ * formatPathForDisplay('/Users/user/.claude/agents/x.md') // => '~/.claude/agents/x.md'
+ * formatPathForDisplay('/Users/user/workspace/file.txt', '/Users/user/workspace') // => 'file.txt'
+ * formatPathForDisplay('./relative/path.txt') // => './relative/path.txt'
+ */
+export declare function formatPathForDisplay(path: string, cwd?: string): string;
+/**
+ * Interface for package table entries
+ */
+export interface PackageTableEntry {
+    name: string;
+    version: string;
+    description?: string;
+    status?: string;
+    type?: string;
+    available?: string;
+}
+/**
+ * Format and display an extended package table with status information (used by list command)
+ */
+export declare function displayExtendedPackageTable(packages: PackageTableEntry[], output?: OutputPort): void;
+/**
+ * Generic table formatter for custom column layouts
+ */
+export declare function displayCustomTable<T>(items: T[], columns: Array<{
+    header: string;
+    width: number;
+    accessor: (item: T) => string;
+}>, title?: string, output?: OutputPort): void;
+/**
+ * Format project summary line
+ */
+export declare function formatProjectSummary(name: string, version: string): string;
+/**
+ * Format tree connector symbols
+ */
+export declare function getTreeConnector(isLast: boolean): string;
+/**
+ * Format tree prefix for nested items
+ */
+export declare function getTreePrefix(prefix: string, isLast: boolean): string;
+/**
+ * Format status with appropriate emoji
+ */
+export declare function formatStatus(status: string): string;
+/**
+ * Format file count with appropriate description
+ */
+export declare function formatFileCount(count: number, type?: string): string;
+/**
+ * Format dependency list for display
+ */
+export declare function formatDependencyList(dependencies: Array<{
+    name: string;
+    version: string;
+}>): string[];
+/**
+ * Format file size in appropriate units (KB or MB)
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Format a single scope as a tag.
+ * Only [global] is shown — [project] is the default context and omitted to reduce noise.
+ */
+export declare function formatScopeTag(scope: string): string;
+/**
+ * Format one or more scopes as a badge.
+ * Only [global] is shown — [project] is the default context and omitted to reduce noise.
+ */
+export declare function formatScopeBadge(scopes: Set<string> | string): string;
+/**
+ * Display package configuration details in a consistent format
+ */
+export declare function displayPackageConfig(packageConfig: PackageYml, path: string, isExisting?: boolean, output?: OutputPort): void;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;GAEG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CA0BtF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAwBpG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;CAC/B,CAAC,EACF,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,UAAU,GAClB,IAAI,CA2BN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAanD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgB,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAErG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAoBpI"}

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

@@ -0,0 +1,196 @@
+import { relative, isAbsolute } from 'path';
+import { normalizePathWithTilde } from './home-directory.js';
+import { consoleOutput } from '../core/ports/console-output.js';
+/**
+ * Formatting utilities for consistent display across commands
+ */
+/**
+ * Format a file system path for display to the user.
+ *
+ * This function provides a unified way to display paths across all commands:
+ * - Uses tilde notation (~) for paths under home directory (e.g., ~/.claude/..., ~/.config/..., ~/.openpackage/...)
+ * - Uses relative paths from cwd for paths in the workspace
+ * - Falls back to absolute path for other cases
+ *
+ * @param path - The path to format (can be absolute or relative)
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Formatted path string for display
+ *
+ * @example
+ * formatPathForDisplay('/Users/user/.openpackage/packages/my-pkg') // => '~/.openpackage/packages/my-pkg'
+ * formatPathForDisplay('/Users/user/.claude/agents/x.md') // => '~/.claude/agents/x.md'
+ * formatPathForDisplay('/Users/user/workspace/file.txt', '/Users/user/workspace') // => 'file.txt'
+ * formatPathForDisplay('./relative/path.txt') // => './relative/path.txt'
+ */
+export function formatPathForDisplay(path, cwd = process.cwd()) {
+    // If path is already in tilde notation, return as-is
+    if (path.startsWith('~')) {
+        return path;
+    }
+    // If path is relative, return as-is
+    if (!isAbsolute(path)) {
+        return path;
+    }
+    // Try relative path from cwd first (paths in workspace take precedence)
+    const relativePath = relative(cwd, path);
+    if (relativePath && !relativePath.startsWith('..')) {
+        // Only use relative path if it's within cwd (doesn't start with ..)
+        return relativePath;
+    }
+    // Use tilde notation for any path under home directory (~/.claude, ~/.config, ~/.cursor, ~/.openpackage, etc.)
+    const tildePath = normalizePathWithTilde(path);
+    if (tildePath.startsWith('~')) {
+        return tildePath;
+    }
+    // Fall back to absolute path
+    return path;
+}
+/**
+ * Format and display an extended package table with status information (used by list command)
+ */
+export function displayExtendedPackageTable(packages, output) {
+    const out = output ?? consoleOutput;
+    if (packages.length === 0) {
+        out.message('No packages found.');
+        return;
+    }
+    // Table header
+    out.message('FORMULA'.padEnd(20) + 'INSTALLED'.padEnd(12) + 'STATUS'.padEnd(15) + 'TYPE'.padEnd(15) + 'AVAILABLE');
+    out.message('-------'.padEnd(20) + '---------'.padEnd(12) + '------'.padEnd(15) + '----'.padEnd(15) + '---------');
+    // Display each package
+    for (const pkg of packages) {
+        const name = pkg.name.padEnd(20);
+        const version = pkg.version.padEnd(12);
+        const status = (pkg.status || '').padEnd(15);
+        const type = (pkg.type || '').padEnd(15);
+        const available = (pkg.available || '-').padEnd(9);
+        out.message(`${name}${version}${status}${type}${available}`);
+    }
+    out.message('');
+    out.message(`Total: ${packages.length} packages`);
+}
+/**
+ * Generic table formatter for custom column layouts
+ */
+export function displayCustomTable(items, columns, title, output) {
+    const out = output ?? consoleOutput;
+    if (title) {
+        out.message(title);
+        out.message('');
+    }
+    if (items.length === 0) {
+        out.message('No items found.');
+        return;
+    }
+    // Build header
+    const headerLine = columns.map(col => col.header.padEnd(col.width)).join('');
+    const separatorLine = columns.map(col => '-'.repeat(col.header.length).padEnd(col.width)).join('');
+    out.message(headerLine);
+    out.message(separatorLine);
+    // Display rows
+    for (const item of items) {
+        const row = columns.map(col => col.accessor(item).padEnd(col.width)).join('');
+        out.message(row);
+    }
+    out.message('');
+    out.message(`Total: ${items.length} items`);
+}
+/**
+ * Format project summary line
+ */
+export function formatProjectSummary(name, version) {
+    return `${name}@${version}`;
+}
+/**
+ * Format tree connector symbols
+ */
+export function getTreeConnector(isLast) {
+    return isLast ? '└── ' : '├── ';
+}
+/**
+ * Format tree prefix for nested items
+ */
+export function getTreePrefix(prefix, isLast) {
+    return prefix + (isLast ? '    ' : '│   ');
+}
+/**
+ * Format status with appropriate emoji
+ */
+export function formatStatus(status) {
+    switch (status.toLowerCase()) {
+        case 'installed':
+            return '✅ installed';
+        case 'missing':
+            return '❌ missing';
+        case 'outdated':
+            return '⚠️  outdated';
+        case 'dependency-mismatch':
+            return '🔄 mismatch';
+        default:
+            return status;
+    }
+}
+/**
+ * Format file count with appropriate description
+ */
+export function formatFileCount(count, type = 'files') {
+    return `${count} ${count === 1 ? type.slice(0, -1) : type}`;
+}
+/**
+ * Format dependency list for display
+ */
+export function formatDependencyList(dependencies) {
+    return dependencies.map(dep => `${dep.name}@${dep.version}`);
+}
+/**
+ * Format file size in appropriate units (KB or MB)
+ */
+export function formatFileSize(bytes) {
+    const mb = bytes / (1024 * 1024);
+    if (mb >= 1) {
+        return `${mb.toFixed(2)}MB`;
+    }
+    const kb = bytes / 1024;
+    return `${kb.toFixed(2)}KB`;
+}
+/**
+ * Format a single scope as a tag.
+ * Only [global] is shown — [project] is the default context and omitted to reduce noise.
+ */
+export function formatScopeTag(scope) {
+    return scope === 'global' ? ' [global]' : '';
+}
+/**
+ * Format one or more scopes as a badge.
+ * Only [global] is shown — [project] is the default context and omitted to reduce noise.
+ */
+export function formatScopeBadge(scopes) {
+    if (typeof scopes === 'string') {
+        return scopes === 'global' ? '[global]' : '';
+    }
+    const hasGlobal = scopes.has('global');
+    return hasGlobal ? '[global]' : '';
+}
+/**
+ * Display package configuration details in a consistent format
+ */
+export function displayPackageConfig(packageConfig, path, isExisting = false, output) {
+    const out = output ?? consoleOutput;
+    const action = isExisting ? 'already exists' : 'created';
+    const displayPath = formatPathForDisplay(path);
+    out.success(`${displayPath} ${action}`);
+    out.message(`  Name: ${packageConfig.name}`);
+    if (packageConfig.version) {
+        out.message(`  Version: ${packageConfig.version}`);
+    }
+    if (packageConfig.description) {
+        out.message(`  Description: ${packageConfig.description}`);
+    }
+    if (packageConfig.keywords && packageConfig.keywords.length > 0) {
+        out.message(`  Keywords: ${packageConfig.keywords.join(', ')}`);
+    }
+    if (packageConfig.private) {
+        out.message(`  Private: Yes`);
+    }
+}
+//# sourceMappingURL=formatters.js.map

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

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

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

@@ -0,0 +1,94 @@
+import { Stats } from 'fs';
+/**
+ * File system utilities with proper error handling
+ */
+/**
+ * Check if a file or directory exists
+ */
+export declare function exists(path: string): Promise<boolean>;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * Check if a path is a file
+ */
+export declare function isFile(path: string): Promise<boolean>;
+/**
+ * Recursively create directories
+ */
+export declare function ensureDir(path: string): Promise<void>;
+/**
+ * Read a file as text
+ */
+export declare function readTextFile(path: string, encoding?: BufferEncoding): Promise<string>;
+/**
+ * Write text to a file
+ */
+export declare function writeTextFile(path: string, content: string, encoding?: BufferEncoding): Promise<void>;
+/**
+ * Copy a file from source to destination
+ */
+export declare function copyFile(src: string, dest: string): Promise<void>;
+/**
+ * Remove a file or directory recursively
+ */
+export declare function remove(path: string): Promise<void>;
+/**
+ * List files in a directory (non-recursive)
+ */
+export declare function listFiles(dirPath: string): Promise<string[]>;
+/**
+ * List directories in a directory (non-recursive)
+ */
+export declare function listDirectories(dirPath: string): Promise<string[]>;
+/**
+ * Recursively remove empty directories under a root (but not the root itself)
+ */
+export declare function removeEmptyDirectories(root: string): Promise<void>;
+/**
+ * Recursively walk through a directory and yield all files
+ */
+export declare function walkFiles(dirPath: string, includePatterns?: string[]): AsyncGenerator<string>;
+/**
+ * Get file stats
+ */
+export declare function getStats(path: string): Promise<Stats>;
+/**
+ * Read JSON file and parse it
+ */
+export declare function readJsonFile<T = any>(path: string): Promise<T>;
+/**
+ * Write object to JSON file
+ */
+export declare function writeJsonFile(path: string, data: any, indent?: number): Promise<void>;
+/**
+ * Read a JSONC file (JSON with Comments) and parse it
+ * JSONC parser also handles standard JSON files
+ */
+export declare function readJsoncFile<T = any>(path: string): Promise<T>;
+/**
+ * Write object to a JSONC-compatible file
+ * Note: Writes standard JSON format (JSONC is a superset that can read JSON)
+ * To add comments, they would need to be manually added to the file
+ */
+export declare function writeJsoncFile(path: string, data: any, indent?: number): Promise<void>;
+/**
+ * Read a JSON or JSONC file (auto-detect format) and parse it
+ * Works with both standard JSON and JSONC (JSON with comments)
+ */
+export declare function readJsonOrJsoncFile<T = any>(path: string): Promise<T>;
+/**
+ * Rename a directory (or file) from source path to destination path.
+ * Ensures the destination parent directory exists and wraps errors consistently.
+ */
+export declare function renameDirectory(srcPath: string, destPath: string): Promise<void>;
+/**
+ * Get the total size of a directory recursively
+ */
+export declare function getDirectorySize(dirPath: string): Promise<number>;
+/**
+ * Count total number of files in a directory (recursive)
+ */
+export declare function countFilesInDirectory(dirPath: string): Promise<number>;
+//# sourceMappingURL=fs.d.ts.map

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

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