opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/install-error-messages.js

@@ -0,0 +1,176 @@
+/**
+ * Phase 6: Enhanced error messages for resource installation.
+ *
+ * Provides helpful, actionable error messages with suggestions
+ * for common failure scenarios.
+ */
+import { extractAllFromPatterns } from './pattern-matcher.js';
+/**
+ * Format an error message for when no pattern matches a resource path.
+ * Provides helpful suggestions based on the path structure.
+ *
+ * @param resourcePath - The path that didn't match
+ * @param platformsConfig - Platforms configuration for pattern extraction
+ * @returns Formatted error message with suggestions
+ */
+export function formatNoPatternMatchError(resourcePath, platformsConfig) {
+    // Extract patterns from platforms config
+    const patterns = extractAllFromPatterns(platformsConfig);
+    const uniquePatterns = Array.from(new Set(patterns));
+    // Analyze the path to provide specific suggestions
+    const pathSegments = resourcePath.split('/').filter(s => s.length > 0);
+    const suggestions = [];
+    // Check if path contains common directory names
+    if (pathSegments.some(s => s === 'agents' || s.includes('agent'))) {
+        suggestions.push('• Did you mean to install an agent? Ensure your path follows the agents/**/*.md pattern');
+    }
+    if (pathSegments.some(s => s === 'skills' || s.includes('skill'))) {
+        suggestions.push('• Did you mean to install a skill? Ensure your path follows the skills/**/* pattern');
+    }
+    if (pathSegments.some(s => s === 'rules' || s.includes('rule'))) {
+        suggestions.push('• Did you mean to install a rule? Ensure your path follows the rules/**/*.md pattern');
+    }
+    if (pathSegments.some(s => s === 'commands' || s.includes('command'))) {
+        suggestions.push('• Did you mean to install a command? Ensure your path follows the commands/**/*.md pattern');
+    }
+    // Build the error message
+    let message = `Path '${resourcePath}' does not match any installable pattern.\n\n`;
+    message += `Installable patterns include:\n`;
+    // Show most common patterns first
+    const commonPatterns = [
+        'agents/**/*.md',
+        'skills/**/*',
+        'rules/**/*.md',
+        'commands/**/*.md'
+    ];
+    for (const pattern of commonPatterns) {
+        if (uniquePatterns.includes(pattern)) {
+            message += `  • ${pattern}\n`;
+        }
+    }
+    // Show other patterns if they exist
+    const otherPatterns = uniquePatterns.filter(p => !commonPatterns.includes(p));
+    if (otherPatterns.length > 0 && otherPatterns.length <= 5) {
+        for (const pattern of otherPatterns) {
+            message += `  • ${pattern}\n`;
+        }
+    }
+    else if (otherPatterns.length > 5) {
+        message += `  • ... and ${otherPatterns.length} more patterns\n`;
+    }
+    if (suggestions.length > 0) {
+        message += `\n💡 Suggestions:\n`;
+        message += suggestions.join('\n');
+    }
+    return message;
+}
+/**
+ * Format an error message for when a resource is not found.
+ *
+ * @param resourceName - Name of the resource
+ * @param resourceType - Type of resource (agent, skill, etc.)
+ * @param availableResources - List of available resources (if any)
+ * @returns Formatted error message
+ */
+export function formatResourceNotFoundError(resourceName, resourceType, availableResources) {
+    let message = `${resourceType.charAt(0).toUpperCase() + resourceType.slice(1)} '${resourceName}' not found.\n`;
+    if (availableResources && availableResources.length > 0) {
+        message += `\nAvailable ${resourceType}s:\n`;
+        const sortedResources = [...availableResources].sort();
+        for (const resource of sortedResources.slice(0, 10)) {
+            message += `  • ${resource}\n`;
+        }
+        if (sortedResources.length > 10) {
+            message += `  • ... and ${sortedResources.length - 10} more\n`;
+        }
+        // Try to find similar names
+        const similar = findSimilarNames(resourceName, availableResources);
+        if (similar.length > 0) {
+            message += `\n💡 Did you mean:\n`;
+            for (const name of similar.slice(0, 3)) {
+                message += `  • ${name}\n`;
+            }
+        }
+    }
+    return message;
+}
+/**
+ * Find names similar to the target name using simple string distance.
+ *
+ * @param target - The target name to match
+ * @param candidates - List of candidate names
+ * @returns Array of similar names (up to 3)
+ */
+function findSimilarNames(target, candidates) {
+    const targetLower = target.toLowerCase();
+    // Score each candidate
+    const scored = candidates.map(candidate => ({
+        name: candidate,
+        score: calculateSimilarity(targetLower, candidate.toLowerCase())
+    }));
+    // Sort by score (higher is better)
+    scored.sort((a, b) => b.score - a.score);
+    // Return top matches with score > 0.5
+    return scored
+        .filter(s => s.score > 0.5)
+        .slice(0, 3)
+        .map(s => s.name);
+}
+/**
+ * Calculate similarity between two strings.
+ * Uses a simple character-based similarity metric.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Similarity score (0-1, higher is more similar)
+ */
+function calculateSimilarity(a, b) {
+    if (a === b)
+        return 1.0;
+    if (a.length === 0 || b.length === 0)
+        return 0.0;
+    // Check for substring match
+    if (a.includes(b) || b.includes(a)) {
+        return 0.8;
+    }
+    // Simple character overlap metric
+    const aChars = new Set(a.split(''));
+    const bChars = new Set(b.split(''));
+    const overlap = [...aChars].filter(c => bChars.has(c)).length;
+    const total = Math.max(aChars.size, bChars.size);
+    return overlap / total;
+}
+/**
+ * Format an error message for version specification on sub-paths.
+ *
+ * @param input - The invalid input string
+ * @returns Formatted error message with correct syntax
+ */
+export function formatVersionOnSubPathError(input) {
+    // Try to extract the parts to provide a corrected example
+    const parts = input.split('@');
+    let suggestion = '';
+    if (parts.length >= 2) {
+        // Assume format like: gh@owner/repo/path@version
+        const beforeVersion = parts.slice(0, -1).join('@');
+        const version = parts[parts.length - 1];
+        const versionPart = version.split('/')[0];
+        // Try to reconstruct: gh@owner/repo@version/path
+        const segments = beforeVersion.split('/');
+        if (segments.length >= 3) {
+            suggestion = `\n\nDid you mean: ${segments.slice(0, 3).join('/')}@${versionPart}/${segments.slice(3).join('/')}`;
+        }
+    }
+    let message = `Version cannot be specified on sub-paths.\n\n`;
+    message += `Got: ${input}\n`;
+    message += `Valid format: <package>[@version][/path]\n`;
+    message += `Examples:\n`;
+    message += `  • gh@owner/repo@v1.0.0/agents/designer.md\n`;
+    message += `  • my-package@1.0.0/skills/git\n`;
+    message += `  • @scope/package@2.0.0/agents/architect\n`;
+    if (suggestion) {
+        message += suggestion;
+    }
+    return message;
+}
+//# sourceMappingURL=install-error-messages.js.map

package/packages/core/dist/utils/install-error-messages.js.map

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

package/packages/core/dist/utils/install-helpers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated This module has moved to core/install/install-helpers.
+ * This re-export exists for backward compatibility.
+ */
+export { extractPackagesFromConfig, getVersionInfoFromDependencyTree, findExistingPathOrGitSource } from '../core/install/install-helpers.js';
+//# sourceMappingURL=install-helpers.d.ts.map

package/packages/core/dist/utils/install-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/install-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC"}

package/packages/core/dist/utils/install-helpers.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated This module has moved to core/install/install-helpers.
+ * This re-export exists for backward compatibility.
+ */
+export { extractPackagesFromConfig, getVersionInfoFromDependencyTree, findExistingPathOrGitSource } from '../core/install/install-helpers.js';
+//# sourceMappingURL=install-helpers.js.map

package/packages/core/dist/utils/install-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.js","sourceRoot":"","sources":["../../src/utils/install-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * JSONC (JSON with Comments) file utilities
+ * Handles reading and parsing JSONC files with comment support
+ */
+/**
+ * Read and parse a JSONC file from the project root
+ * @param relativePath - Path relative to project root (e.g., 'platforms.jsonc')
+ * @returns Parsed JSON object
+ */
+export declare function readJsoncFileSync<T = unknown>(relativePath: string): T;
+/**
+ * Read and parse a JSONC or JSON file from an absolute path.
+ * Returns undefined if the file doesn't exist, parsing fails, or result is not a plain object.
+ * @param fullPath - Absolute path to the file
+ * @returns Parsed object or undefined
+ */
+export declare function readJsoncOrJson(fullPath: string): Record<string, any> | undefined;
+//# sourceMappingURL=jsonc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../src/utils/jsonc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAiBtE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAiBjF"}

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

@@ -0,0 +1,79 @@
+/**
+ * JSONC (JSON with Comments) file utilities
+ * Handles reading and parsing JSONC files with comment support
+ */
+import { readFileSync, existsSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { parse } from 'jsonc-parser';
+import { logger } from './logger.js';
+/**
+ * Get the project root directory by walking up from the current file's
+ * location until we find platforms.jsonc (a known root marker).
+ *
+ * This approach is resilient to monorepo restructuring and esbuild bundling,
+ * where the runtime __dirname may be at varying depths relative to the
+ * repository root (e.g. packages/core/src/utils, packages/cli/dist, etc.).
+ */
+function getProjectRoot() {
+    const __filename = fileURLToPath(import.meta.url);
+    let dir = dirname(__filename);
+    // Walk up at most 10 levels to find the directory containing platforms.jsonc
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, 'platforms.jsonc'))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // reached filesystem root
+        dir = parent;
+    }
+    // Fallback: return two levels up (original behaviour) so we get a clear
+    // error message pointing at the resolved path rather than a silent failure.
+    const fallback = dirname(__filename);
+    return join(fallback, '..', '..');
+}
+/**
+ * Read and parse a JSONC file from the project root
+ * @param relativePath - Path relative to project root (e.g., 'platforms.jsonc')
+ * @returns Parsed JSON object
+ */
+export function readJsoncFileSync(relativePath) {
+    const projectRoot = getProjectRoot();
+    const fullPath = join(projectRoot, relativePath);
+    try {
+        const content = readFileSync(fullPath, 'utf-8');
+        const parsed = parse(content);
+        if (parsed === undefined) {
+            throw new Error(`Failed to parse JSONC file: ${relativePath}`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        logger.error(`Failed to read JSONC file: ${relativePath}`, { error, fullPath });
+        throw new Error(`Failed to read JSONC file ${relativePath}: ${error}`);
+    }
+}
+/**
+ * Read and parse a JSONC or JSON file from an absolute path.
+ * Returns undefined if the file doesn't exist, parsing fails, or result is not a plain object.
+ * @param fullPath - Absolute path to the file
+ * @returns Parsed object or undefined
+ */
+export function readJsoncOrJson(fullPath) {
+    if (!existsSync(fullPath)) {
+        return undefined;
+    }
+    try {
+        const content = readFileSync(fullPath, 'utf-8');
+        const parsed = parse(content);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed) && parsed !== null) {
+            return parsed;
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to parse JSONC/JSON file ${fullPath}: ${error.message}`);
+    }
+    return undefined;
+}
+//# sourceMappingURL=jsonc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.js","sourceRoot":"","sources":["../../src/utils/jsonc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;GAOG;AACH,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9B,6EAA6E;IAC7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,CAAC,0BAA0B;QACrD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAc,YAAoB;IACjE,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,MAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,KAAK,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACtF,OAAO,MAA6B,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,19 @@
+import { Logger, LogLevel } from '../types/index.js';
+/**
+ * Simple console-based logger with support for different log levels
+ */
+declare class ConsoleLogger implements Logger {
+    private level;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    private formatMessage;
+    private getPrefix;
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    setLevel(level: LogLevel): void;
+}
+export declare const logger: ConsoleLogger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,cAAM,aAAc,YAAW,MAAM;IACnC,OAAO,CAAC,KAAK,CAAW;gBAEZ,KAAK,GAAE,QAAwB;IAI3C,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,SAAS;IAejB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGhC;AAGD,eAAO,MAAM,MAAM,eAMlB,CAAC"}

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

@@ -0,0 +1,78 @@
+import { LogLevel } from '../types/index.js';
+/**
+ * Simple console-based logger with support for different log levels
+ */
+class ConsoleLogger {
+    constructor(level = LogLevel.INFO) {
+        this.level = level;
+    }
+    shouldLog(level) {
+        const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];
+        const currentLevelIndex = levels.indexOf(this.level);
+        const messageLevelIndex = levels.indexOf(level);
+        return messageLevelIndex >= currentLevelIndex;
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const prefix = this.getPrefix(level);
+        let formatted = `${timestamp} ${prefix} ${message}`;
+        if (meta && typeof meta === 'object') {
+            // Handle Error objects specifically since JSON.stringify(new Error()) is {}
+            const metaToLog = meta instanceof Error ? {
+                ...meta,
+                name: meta.name,
+                message: meta.message,
+                stack: meta.stack
+            } : meta;
+            formatted += `\n${JSON.stringify(metaToLog, null, 2)}`;
+        }
+        else if (meta) {
+            formatted += ` ${meta}`;
+        }
+        return formatted;
+    }
+    getPrefix(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return '🐛 [DEBUG]';
+            case LogLevel.INFO:
+                return 'ℹ️  [INFO] ';
+            case LogLevel.WARN:
+                return '⚠️  [WARN] ';
+            case LogLevel.ERROR:
+                return '❌ [ERROR]';
+            default:
+                return '[LOG]  ';
+        }
+    }
+    debug(message, meta) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            console.debug(this.formatMessage(LogLevel.DEBUG, message, meta));
+        }
+    }
+    info(message, meta) {
+        if (this.shouldLog(LogLevel.INFO)) {
+            console.info(this.formatMessage(LogLevel.INFO, message, meta));
+        }
+    }
+    warn(message, meta) {
+        if (this.shouldLog(LogLevel.WARN)) {
+            console.warn(this.formatMessage(LogLevel.WARN, message, meta));
+        }
+    }
+    error(message, meta) {
+        if (this.shouldLog(LogLevel.ERROR)) {
+            console.error(this.formatMessage(LogLevel.ERROR, message, meta));
+        }
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+}
+// Create and export a default logger instance
+export const logger = new ConsoleLogger(process.env.OPKG_VERBOSE === '1'
+    ? LogLevel.DEBUG
+    : process.env.NODE_ENV === 'development'
+        ? LogLevel.INFO
+        : LogLevel.ERROR);
+//# sourceMappingURL=logger.js.map

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

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

package/packages/core/dist/utils/manifest-paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Normalize package-internal paths for consistent comparisons.
+ * Strips leading slash and converts to forward slashes.
+ */
+export declare function normalizePackagePath(path: string): string;
+/**
+ * Determine if a path points to a package manifest (either bare or canonical).
+ */
+export declare function isManifestPath(path: string): boolean;
+//# sourceMappingURL=manifest-paths.d.ts.map

package/packages/core/dist/utils/manifest-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-paths.d.ts","sourceRoot":"","sources":["../../src/utils/manifest-paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpD"}

package/packages/core/dist/utils/manifest-paths.js

@@ -0,0 +1,19 @@
+import { FILE_PATTERNS, PACKAGE_PATHS } from '../constants/index.js';
+import { normalizePathForProcessing } from './path-normalization.js';
+/**
+ * Normalize package-internal paths for consistent comparisons.
+ * Strips leading slash and converts to forward slashes.
+ */
+export function normalizePackagePath(path) {
+    const trimmed = path.startsWith('/') ? path.slice(1) : path;
+    return normalizePathForProcessing(trimmed);
+}
+/**
+ * Determine if a path points to a package manifest (either bare or canonical).
+ */
+export function isManifestPath(path) {
+    const normalized = normalizePackagePath(path);
+    return (normalized === FILE_PATTERNS.OPENPACKAGE_YML ||
+        normalized === PACKAGE_PATHS.MANIFEST_RELATIVE);
+}
+//# sourceMappingURL=manifest-paths.js.map

package/packages/core/dist/utils/manifest-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-paths.js","sourceRoot":"","sources":["../../src/utils/manifest-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CACL,UAAU,KAAK,aAAa,CAAC,eAAe;QAC5C,UAAU,KAAK,aAAa,CAAC,iBAAiB,CAC/C,CAAC;AACJ,CAAC"}

package/packages/core/dist/utils/package-copy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Package file I/O utilities for reading from and writing to package directories.
+ *
+ * This module provides two main operations:
+ *   - readPackageFilesForRegistry: Collect files from a package directory into a
+ *     registry-ready payload, applying static exclusions (no manifest filters).
+ *   - writePackageFilesToDirectory: Write a set of PackageFile entries to disk,
+ *     syncing the directory contents (removing stale files).
+ */
+import type { PackageFile } from '../types/index.js';
+/**
+ * Read package files from disk and return a registry-ready payload.
+ *
+ * Applies static exclusions (package index file, packages/** nested dirs).
+ *
+ * @param packageDir - Absolute path to the package root directory.
+ * @returns Array of PackageFile entries representing the canonical payload.
+ */
+export declare function readPackageFilesForRegistry(packageDir: string): Promise<PackageFile[]>;
+export interface WritePackageFilesOptions {
+    /**
+     * When true, preserve the package index file even if it's not in the
+     * incoming file list. Useful when writing to the local cache where the
+     * index should persist across updates.
+     */
+    preserveIndexFile?: boolean;
+}
+/**
+ * Write package files to a directory, syncing its contents.
+ *
+ * - Creates the target directory if it doesn't exist.
+ * - Removes files that are no longer part of the payload (except protected paths).
+ * - Writes all incoming files, creating subdirectories as needed.
+ *
+ * @param targetDir - Absolute path to the destination directory.
+ * @param files - Array of PackageFile entries to write.
+ * @param options - Optional settings (e.g., preserveIndexFile).
+ */
+export declare function writePackageFilesToDirectory(targetDir: string, files: PackageFile[], options?: WritePackageFilesOptions): Promise<void>;
+//# sourceMappingURL=package-copy.d.ts.map

package/packages/core/dist/utils/package-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-copy.d.ts","sourceRoot":"","sources":["../../src/utils/package-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkBrD;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAqB5F;AAMD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAef"}

package/packages/core/dist/utils/package-copy.js

@@ -0,0 +1,101 @@
+/**
+ * Package file I/O utilities for reading from and writing to package directories.
+ *
+ * This module provides two main operations:
+ *   - readPackageFilesForRegistry: Collect files from a package directory into a
+ *     registry-ready payload, applying static exclusions (no manifest filters).
+ *   - writePackageFilesToDirectory: Write a set of PackageFile entries to disk,
+ *     syncing the directory contents (removing stale files).
+ */
+import { join, relative, dirname } from 'path';
+import { FILE_PATTERNS } from '../constants/index.js';
+import { exists, ensureDir, readTextFile, writeTextFile, walkFiles, remove } from './fs.js';
+import { logger } from './logger.js';
+import { normalizePathForProcessing } from './path-normalization.js';
+import { isExcludedFromPackage } from './package-filters.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Reading package files
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Read package files from disk and return a registry-ready payload.
+ *
+ * Applies static exclusions (package index file, packages/** nested dirs).
+ *
+ * @param packageDir - Absolute path to the package root directory.
+ * @returns Array of PackageFile entries representing the canonical payload.
+ */
+export async function readPackageFilesForRegistry(packageDir) {
+    if (!(await exists(packageDir))) {
+        return [];
+    }
+    const files = [];
+    for await (const fullPath of walkFiles(packageDir)) {
+        const relativePath = normalizePathForProcessing(relative(packageDir, fullPath));
+        // Layer 1: static exclusions (always enforced)
+        if (isExcludedFromPackage(relativePath)) {
+            logger.debug(`Skipping static-excluded path: ${relativePath}`);
+            continue;
+        }
+        const content = await readTextFile(fullPath);
+        files.push({ path: relativePath, content, encoding: 'utf8' });
+    }
+    return files;
+}
+/**
+ * Write package files to a directory, syncing its contents.
+ *
+ * - Creates the target directory if it doesn't exist.
+ * - Removes files that are no longer part of the payload (except protected paths).
+ * - Writes all incoming files, creating subdirectories as needed.
+ *
+ * @param targetDir - Absolute path to the destination directory.
+ * @param files - Array of PackageFile entries to write.
+ * @param options - Optional settings (e.g., preserveIndexFile).
+ */
+export async function writePackageFilesToDirectory(targetDir, files, options = {}) {
+    await ensureDir(targetDir);
+    // Build the set of paths that should remain after the write
+    const pathsToKeep = new Set(files.map(f => normalizePathForProcessing(f.path)));
+    if (options.preserveIndexFile) {
+        pathsToKeep.add(FILE_PATTERNS.OPENPACKAGE_INDEX_YML);
+    }
+    // Remove stale files (but never touch protected paths like packages/**)
+    await removeStaleFiles(targetDir, pathsToKeep);
+    // Write all incoming files in parallel
+    await Promise.all(files.map(file => writeFile(targetDir, file)));
+}
+/**
+ * Remove files in targetDir that are not in pathsToKeep and are not protected.
+ */
+async function removeStaleFiles(targetDir, pathsToKeep) {
+    if (!(await exists(targetDir))) {
+        return;
+    }
+    for await (const fullPath of walkFiles(targetDir)) {
+        const relPath = normalizePathForProcessing(relative(targetDir, fullPath));
+        // Skip files we want to keep
+        if (pathsToKeep.has(relPath)) {
+            continue;
+        }
+        // Never delete protected paths (e.g., packages/**)
+        if (isExcludedFromPackage(relPath)) {
+            continue;
+        }
+        try {
+            await remove(fullPath);
+            logger.debug(`Removed stale file: ${relPath}`);
+        }
+        catch (error) {
+            logger.warn(`Failed to remove stale file ${relPath}: ${error}`);
+        }
+    }
+}
+/**
+ * Write a single PackageFile to disk under targetDir.
+ */
+async function writeFile(targetDir, file) {
+    const targetPath = join(targetDir, file.path);
+    await ensureDir(dirname(targetPath));
+    await writeTextFile(targetPath, file.content, file.encoding ?? 'utf8');
+}
+//# sourceMappingURL=package-copy.js.map

package/packages/core/dist/utils/package-copy.js.map

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

package/packages/core/dist/utils/package-filters.d.ts

@@ -0,0 +1,2 @@
+export declare function isExcludedFromPackage(relativePath: string): boolean;
+//# sourceMappingURL=package-filters.d.ts.map

package/packages/core/dist/utils/package-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-filters.d.ts","sourceRoot":"","sources":["../../src/utils/package-filters.ts"],"names":[],"mappings":"AAWA,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAwBnE"}