opkg 0.6.1 → 0.7.0

package/dist/constants/index.js

@@ -4,14 +4,15 @@
  * file patterns, and other constants used throughout the application.
  */
 export const DIR_PATTERNS = {
-    OPENPACKAGE: '.openpackage'
+    OPENPACKAGE: '.openpackage',
+    CLAUDE_PLUGIN: '.claude-plugin'
 };
 export const FILE_PATTERNS = {
     MD_FILES: '.md',
     MDC_FILES: '.mdc',
     TOML_FILES: '.toml',
-    PACKAGE_YML: 'package.yml',
-    PACKAGE_INDEX_YML: 'package.index.yml',
+    OPENPACKAGE_YML: 'openpackage.yml',
+    OPENPACKAGE_INDEX_YML: 'openpackage.index.yml',
     README_MD: 'README.md',
     // Platform-specific root files
     AGENTS_MD: 'AGENTS.md',
@@ -23,13 +24,8 @@ export const FILE_PATTERNS = {
     MARKDOWN_FILES: ['.md', '.mdc'],
     YML_FILE: '.yml',
 };
-// Universal subdirectory names used across all platforms
-export const UNIVERSAL_SUBDIRS = {
-    RULES: 'rules',
-    COMMANDS: 'commands',
-    AGENTS: 'agents',
-    SKILLS: 'skills'
-};
+// Universal subdirectory names are now dynamically discovered from platform configs
+// No hardcoded subdirs - platforms define their own universal directories
 export const OPENPACKAGE_DIRS = {
     REGISTRY: 'registry',
     PACKAGES: 'packages',
@@ -37,19 +33,29 @@ export const OPENPACKAGE_DIRS = {
     RUNTIME: 'runtime'
 };
 /**
- * Canonical paths within a package (relative to the package root).
+ * Package root directory names (relative to package root).
+ */
+export const PACKAGE_ROOT_DIRS = {
+    /**
+     * Direct copy directory: files under `root/**` are copied 1:1 to workspace root
+     * with the `root/` prefix stripped during install.
+     */
+    ROOT_COPY: 'root'
+};
+/**
+ * Canonical paths within a package or cached copy (relative to the package root).
  */
 export const PACKAGE_PATHS = {
     /**
      * The canonical location of the package manifest within a package:
-     * <package-root>/.openpackage/package.yml
+     * <package-root>/openpackage.yml
      */
-    MANIFEST_RELATIVE: `${DIR_PATTERNS.OPENPACKAGE}/${FILE_PATTERNS.PACKAGE_YML}`,
+    MANIFEST_RELATIVE: `${FILE_PATTERNS.OPENPACKAGE_YML}`,
     /**
-     * The canonical location of the package index file within a package:
-     * <package-root>/.openpackage/package.index.yml
+     * The canonical location of the package index file within a cached package copy:
+     * <cached-package-root>/openpackage.index.yml
      */
-    INDEX_RELATIVE: `${DIR_PATTERNS.OPENPACKAGE}/${FILE_PATTERNS.PACKAGE_INDEX_YML}`,
+    INDEX_RELATIVE: `${FILE_PATTERNS.OPENPACKAGE_INDEX_YML}`,
 };
 export const DEPENDENCY_ARRAYS = {
     PACKAGES: 'packages',
@@ -61,4 +67,54 @@ export const CONFLICT_RESOLUTION = {
     OVERWRITTEN: 'overwritten'
 };
 export const UNVERSIONED = '0.0.0';
+/**
+ * Source type constants for package resolution.
+ */
+export const SOURCE_TYPES = {
+    PATH: 'path',
+    REGISTRY: 'registry',
+    GIT: 'git'
+};
+/**
+ * Mutability constants for package sources.
+ */
+export const MUTABILITY = {
+    MUTABLE: 'mutable',
+    IMMUTABLE: 'immutable'
+};
+/**
+ * Resolution source constants (where version was resolved from).
+ */
+export const RESOLUTION_SOURCES = {
+    LOCAL: 'local',
+    REMOTE: 'remote'
+};
+/**
+ * Git-related constants.
+ */
+export const GIT = {
+    DIRECTORY: 'git',
+    DEFAULT_REF: 'HEAD',
+    COMMANDS: {
+        CLONE: 'clone',
+        FETCH: 'fetch',
+        CHECKOUT: 'checkout',
+        PULL: 'pull',
+        DEPTH_FLAG: '--depth',
+        DEPTH_VALUE: '1',
+        BRANCH_FLAG: '--branch',
+        ORIGIN: 'origin'
+    }
+};
+/**
+ * Default version constraint (wildcard/latest).
+ */
+export const DEFAULT_VERSION_CONSTRAINT = '*';
+/**
+ * Registry path prefixes (for constructing declared paths).
+ */
+export const REGISTRY_PATH_PREFIXES = {
+    BASE: '~/.openpackage/registry/',
+    GIT: '~/.openpackage/registry/git/'
+};
 //# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,cAAc;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;IACtB,+BAA+B;IAC/B,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,uBAAuB;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM;CACR,CAAC;AAEX,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;OAGG;IACH,iBAAiB,EAAE,GAAG,YAAY,CAAC,WAAW,IAAI,aAAa,CAAC,WAAW,EAAE;IAC7E;;;OAGG;IACH,cAAc,EAAE,GAAG,YAAY,CAAC,WAAW,IAAI,aAAa,CAAC,iBAAiB,EAAE;CACxE,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;CACpB,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,OAAO;IACnB,eAAe,EAAE,iBAAiB;IAClC,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;IACtB,+BAA+B;IAC/B,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,uBAAuB;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM;CACR,CAAC;AAEX,oFAAoF;AACpF,0EAA0E;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;OAGG;IACH,iBAAiB,EAAE,GAAG,aAAa,CAAC,eAAe,EAAE;IACrD;;;OAGG;IACH,cAAc,EAAE,GAAG,aAAa,CAAC,qBAAqB,EAAE;CAChD,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;CACpB,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;CACF,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE;QACR,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,MAAM;QACZ,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE,QAAQ;KACjB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,0BAA0B;IAChC,GAAG,EAAE,8BAA8B;CAC3B,CAAC"}

package/dist/core/add/add-conflict-handler.js

@@ -1,5 +1,4 @@
 import { dirname, join } from 'path';
-import { DIR_PATTERNS } from '../../constants/index.js';
 import { ensureDir, exists, readTextFile, writeTextFile } from '../../utils/fs.js';
 import { safePrompts } from '../../utils/prompts.js';
 import { UserCancellationError } from '../../utils/errors.js';
@@ -10,13 +9,7 @@ import { logger } from '../../utils/logger.js';
  * - Otherwise, write to package root directory
  */
 function resolveTargetPath(packageContext, registryPath) {
-    const openpackagePrefix = `${DIR_PATTERNS.OPENPACKAGE}/`;
-    if (registryPath.startsWith(openpackagePrefix)) {
-        // Universal content: strip prefix and write to content directory
-        const relativePath = registryPath.slice(openpackagePrefix.length);
-        return join(packageContext.packageFilesDir, relativePath);
-    }
-    // Root-level content: write to package root directory
+    // V2: registry paths are package-root-relative (universal subdirs already at root)
     return join(packageContext.packageRootDir, registryPath);
 }
 export async function copyFilesWithConflictResolution(packageContext, entries) {

package/dist/core/add/add-conflict-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-conflict-handler.js","sourceRoot":"","sources":["../../../src/core/add/add-conflict-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"add-conflict-handler.js","sourceRoot":"","sources":["../../../src/core/add/add-conflict-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIrC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM/C;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,cAA8B,EAAE,YAAoB;IAC7E,mFAAmF;IACnF,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,cAA8B,EAC9B,OAAsB;IAEtB,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,oDAAoD;QACpD,MAAM,WAAW,GAAG,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAE1E,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAE7C,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAExE,IAAI,eAAe,KAAK,aAAa,EAAE,CAAC;gBACtC,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;YACxE,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACjC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC7D,SAAS;YACX,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QACtC,MAAM,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAEhD,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC,YAAY;YACxB,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,WAAmB,EAAE,YAAoB;IAC7E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;QACjC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,SAAS,YAAY,gCAAgC,WAAW,2BAA2B;QACpG,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,eAAe,EAAE;YAC9D,EAAE,KAAK,EAAE,6BAA6B,EAAE,KAAK,EAAE,WAAW,EAAE;YAC5D,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE;SAC/C;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,QAAQ,CAAC,QAA4B,CAAC;AAC/C,CAAC"}

package/dist/core/add/add-pipeline.js

@@ -5,13 +5,12 @@ import { readPackageFilesForRegistry } from '../../utils/package-copy.js';
 import { ensurePackageWithYml } from '../../utils/package-management.js';
 import { isWithinDirectory } from '../../utils/path-normalization.js';
 import { exists, isDirectory, isFile, ensureDir } from '../../utils/fs.js';
-import { writePackageYml } from '../../utils/package-yml.js';
-import { promptPackageDetails } from '../../utils/prompts.js';
 import { logger } from '../../utils/logger.js';
 import { collectSourceEntries } from './source-collector.js';
 import { applyPlatformSpecificPaths } from './platform-path-transformer.js';
 import { copyFilesWithConflictResolution } from './add-conflict-handler.js';
-import { detectPackageContext, getNoPackageDetectedMessage, getPackageFilesDir, getPackageYmlPath, createPackageContext } from '../package-context.js';
+import { detectPackageContext, getNoPackageDetectedMessage, getPackageYmlPath } from '../package-context.js';
+import { createPackage } from '../package-creation.js';
 import { DIR_PATTERNS } from '../../constants/index.js';
 export async function runAddPipeline(packageOrPath, pathArg, options = {}) {
     const cwd = process.cwd();
@@ -79,13 +78,16 @@ async function resolveAddTargets(cwd, packageOrPath, pathArg) {
     return { type: 'detected', context, inputPath: singleArg };
 }
 async function initRootPackageForAdd(cwd) {
-    const packageFilesDir = getPackageFilesDir(cwd, 'root');
-    const packageYmlPath = getPackageYmlPath(cwd, 'root');
-    logger.info(`No package detected at current directory; initializing root package in: ${packageFilesDir}`);
-    await ensureDir(packageFilesDir);
-    const packageConfig = await promptPackageDetails();
-    await writePackageYml(packageYmlPath, packageConfig);
-    return createPackageContext(cwd, packageConfig, 'root');
+    logger.info(`No package detected at current directory; creating root package for add operation`);
+    const result = await createPackage({
+        cwd,
+        scope: 'root',
+        interactive: true
+    });
+    if (!result.success || !result.context) {
+        throw new Error(result.error || 'Failed to create root package for add operation');
+    }
+    return result.context;
 }
 async function buildAddPackageContext(cwd, resolved) {
     if (resolved.type === 'detected') {

package/dist/core/add/add-pipeline.js.map

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

package/dist/core/add/add-to-source-pipeline.js

@@ -0,0 +1,123 @@
+import { resolve as resolvePath, join } from 'path';
+import { FILE_PATTERNS } from '../../constants/index.js';
+import { resolveMutableSource } from '../source-resolution/resolve-mutable-source.js';
+import { resolvePackageSource } from '../source-resolution/resolve-package-source.js';
+import { assertMutableSourceOrThrow } from '../../utils/source-mutability.js';
+import { collectSourceEntries } from './source-collector.js';
+import { copyFilesWithConflictResolution } from './add-conflict-handler.js';
+import { normalizePathForProcessing } from '../../utils/path-normalization.js';
+import { getPlatformRootFileNames } from '../../utils/platform-root-files.js';
+import { getAllUniversalSubdirs, getAllPlatforms } from '../platforms.js';
+import { parsePackageYml } from '../../utils/package-yml.js';
+import { exists } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+export async function runAddToSourcePipeline(packageName, pathArg, options = {}) {
+    const cwd = process.cwd();
+    if (!packageName) {
+        return { success: false, error: 'Package name is required for add.' };
+    }
+    if (!pathArg) {
+        return { success: false, error: 'Path argument is required for add.' };
+    }
+    const absInputPath = resolvePath(cwd, pathArg);
+    if (!(await exists(absInputPath))) {
+        return { success: false, error: `Path not found: ${pathArg}` };
+    }
+    // Resolve mutable package source (workspace or global, but not registry)
+    let source;
+    try {
+        source = await resolveMutableSource({ cwd, packageName });
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    // Additional safety check (should never fail given resolveMutableSource guarantees)
+    assertMutableSourceOrThrow(source.absolutePath, { packageName: source.packageName, command: 'add' });
+    logger.info('Adding files to package source', {
+        packageName: source.packageName,
+        sourcePath: source.absolutePath,
+        sourceType: source.sourceType,
+        inputPath: pathArg
+    });
+    const rawEntries = await collectSourceEntries(absInputPath, cwd);
+    const entries = applyCopyToRootRule(rawEntries, cwd);
+    const packageContext = await buildPackageContext(source);
+    const changed = await copyFilesWithConflictResolution(packageContext, entries);
+    logger.info('Files copied to package source', {
+        packageName: source.packageName,
+        filesAdded: changed.length
+    });
+    // Determine source type for result
+    const sourceType = source.absolutePath.includes(`${cwd}/.openpackage/packages/`)
+        ? 'workspace'
+        : 'global';
+    // Handle --apply flag: requires package to be installed in current workspace
+    if (options.apply) {
+        logger.info('Applying changes to workspace (--apply flag)', { packageName: source.packageName });
+        try {
+            // Check if package is installed in current workspace
+            await resolvePackageSource(cwd, packageName);
+            // Apply changes to workspace
+            const { runApplyPipeline } = await import('../apply/apply-pipeline.js');
+            const applyResult = await runApplyPipeline(source.packageName, {});
+            if (!applyResult.success) {
+                return {
+                    success: false,
+                    error: `Files added to package source, but apply failed:\n${applyResult.error}`
+                };
+            }
+            logger.info('Changes applied to workspace', { packageName: source.packageName });
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Files added to package source at: ${source.absolutePath}\n\n` +
+                    `However, --apply failed because package '${packageName}' is not installed in this workspace.\n\n` +
+                    `To sync changes to your workspace:\n` +
+                    `  1. Install the package: opkg install ${packageName}\n` +
+                    `  2. Apply the changes: opkg apply ${packageName}\n\n` +
+                    `Or run 'opkg add' without --apply flag to skip workspace sync.`
+            };
+        }
+    }
+    return {
+        success: true,
+        data: {
+            packageName: source.packageName,
+            filesAdded: changed.length,
+            sourcePath: source.absolutePath,
+            sourceType
+        }
+    };
+}
+function applyCopyToRootRule(entries, cwd) {
+    const universalSubdirs = getAllUniversalSubdirs(cwd);
+    const rootFileNames = getPlatformRootFileNames(getAllPlatforms(undefined, cwd), cwd);
+    return entries.map(entry => {
+        const normalized = normalizePathForProcessing(entry.registryPath) || entry.registryPath;
+        const isUniversal = universalSubdirs.has(normalized.split('/')[0] || '') ||
+            normalized.startsWith(`${FILE_PATTERNS.AGENTS_MD}`) ||
+            normalized.startsWith('root/');
+        const isRootFile = rootFileNames.has(normalized);
+        if (isUniversal || isRootFile) {
+            return { ...entry, registryPath: normalized };
+        }
+        // Everything else → copy-to-root
+        return { ...entry, registryPath: normalizePathForProcessing(`root/${normalized}`) || `root/${normalized}` };
+    });
+}
+async function buildPackageContext(source) {
+    const packageYmlPath = join(source.absolutePath, FILE_PATTERNS.OPENPACKAGE_YML);
+    const config = await parsePackageYml(packageYmlPath);
+    return {
+        name: source.packageName,
+        version: config.version,
+        config,
+        packageYmlPath,
+        packageRootDir: source.absolutePath,
+        packageFilesDir: source.absolutePath,
+        location: 'nested',
+        isCwdPackage: false
+    };
+}
+//# sourceMappingURL=add-to-source-pipeline.js.map

package/dist/core/add/add-to-source-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-to-source-pipeline.js","sourceRoot":"","sources":["../../../src/core/add/add-to-source-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAoB,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAc/C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAA+B,EAC/B,OAA2B,EAC3B,UAA8B,EAAE;IAEhC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,OAAO,EAAE,EAAE,CAAC;IACjE,CAAC;IAED,yEAAyE;IACzE,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3F,CAAC;IAED,oFAAoF;IACpF,0BAA0B,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAErG,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;QAC5C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,YAAY;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAErD,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,+BAA+B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAE/E,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;QAC5C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,OAAO,CAAC,MAAM;KAC3B,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,GAAG,yBAAyB,CAAC;QAC9E,CAAC,CAAC,WAAoB;QACtB,CAAC,CAAC,QAAiB,CAAC;IAEtB,6EAA6E;IAC7E,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAEjG,IAAI,CAAC;YACH,qDAAqD;YACrD,MAAM,oBAAoB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAE7C,6BAA6B;YAC7B,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACxE,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAEnE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,qDAAqD,WAAW,CAAC,KAAK,EAAE;iBAChF,CAAC;YACJ,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,qCAAqC,MAAM,CAAC,YAAY,MAAM;oBAC9D,4CAA4C,WAAW,2CAA2C;oBAClG,sCAAsC;oBACtC,0CAA0C,WAAW,IAAI;oBACzD,sCAAsC,WAAW,MAAM;oBACvD,gEAAgE;aACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,UAAU,EAAE,MAAM,CAAC,YAAY;YAC/B,UAAU;SACX;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAsB,EAAE,GAAW;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,wBAAwB,CAAC,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAErF,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACzB,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC;QAExF,MAAM,WAAW,GACf,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpD,UAAU,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;YACnD,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEjD,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;YAC9B,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;QAChD,CAAC;QAED,iCAAiC;QACjC,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,0BAA0B,CAAC,QAAQ,UAAU,EAAE,CAAC,IAAI,QAAQ,UAAU,EAAE,EAAE,CAAC;IAC9G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,MAAwD;IACzF,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IAErD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,WAAW;QACxB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM;QACN,cAAc;QACd,cAAc,EAAE,MAAM,CAAC,YAAY;QACnC,eAAe,EAAE,MAAM,CAAC,YAAY;QACpC,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/core/add/package-index-updater.js

@@ -1,4 +1,4 @@
-import { dirname, join } from 'path';
+import { join } from 'path';
 import { FILE_PATTERNS } from '../../constants/index.js';
 import { exists } from '../../utils/fs.js';
 import { logger } from '../../utils/logger.js';
@@ -8,20 +8,22 @@ import { buildIndexMappingForPackageFiles, loadOtherPackageIndexes } from '../..
 import { UNVERSIONED } from '../../constants/index.js';
 import { parseUniversalPath } from '../../utils/platform-file.js';
 import { mapUniversalToPlatform } from '../../utils/platform-mapper.js';
-import { isPlatformId } from '../platforms.js';
+import { getAllUniversalSubdirs, isPlatformId } from '../platforms.js';
 import { normalizeRegistryPath, isRootRegistryPath, isSkippableRegistryPath, isAllowedRegistryPath } from '../../utils/registry-entry-filter.js';
 import { createWorkspaceHash } from '../../utils/version-generator.js';
+import { getPlatformRootFileNames, stripRootCopyPrefix, isRootCopyPath } from '../../utils/platform-root-files.js';
 /**
  * Compute the directory key (registry side) to collapse file mappings under.
  * Mirrors the grouping behavior used by install/index mapping logic.
  */
-export function computeDirKeyFromRegistryPath(registryPath) {
+export function computeDirKeyFromRegistryPath(registryPath, cwd) {
     const normalized = registryPath.replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
     const parts = normalized.split('/');
     if (parts.length <= 1)
         return '';
-    const universal = new Set(['ai', 'rules', 'commands', 'agents', 'skills']);
-    if (universal.has(parts[0])) {
+    // Use dynamically discovered universal subdirs instead of hardcoded list
+    const universalSubdirs = getAllUniversalSubdirs(cwd);
+    if (universalSubdirs.has(parts[0])) {
         if (parts.length >= 2)
             return `${parts[0]}/${parts[1]}/`;
         return `${parts[0]}/`;
@@ -88,59 +90,6 @@ function mergeMappingsRespectingExisting(previous, updates, replaceExact = false
     }
     return sortMapping(merged);
 }
-/**
- * Collapse file entries into directory keys when appropriate.
- * Groups file entries by their directory key and automatically collapses them into dir key entries.
- * This is universally applied to all eligible groups to ensure consistent index structure.
- */
-function collapseFileEntriesToDirKeys(mapping) {
-    const collapsed = {};
-    const dirKeyGroups = new Map();
-    // Group file entries by their directory key
-    for (const [key, values] of Object.entries(mapping)) {
-        // Skip directory keys (they already end with /)
-        if (key.endsWith('/')) {
-            collapsed[key] = values;
-            continue;
-        }
-        const dirKey = computeDirKeyFromRegistryPath(key);
-        if (!dirKey) {
-            // No dir key possible, keep as file entry
-            collapsed[key] = values;
-            continue;
-        }
-        if (!dirKeyGroups.has(dirKey)) {
-            dirKeyGroups.set(dirKey, []);
-        }
-        dirKeyGroups.get(dirKey).push({ key, values });
-    }
-    // Process each directory group - always collapse when multiple files share a dir key
-    for (const [dirKey, entries] of dirKeyGroups.entries()) {
-        // Collapse: collect all installed directories from file entries
-        const dirValues = new Set();
-        for (const entry of entries) {
-            for (const v of entry.values) {
-                const d = dirname(v);
-                if (d && d !== '.') {
-                    const normalized = d.endsWith('/') ? d : `${d}/`;
-                    dirValues.add(normalized);
-                }
-            }
-        }
-        if (dirValues.size > 0) {
-            // Replace file entries with a single dir key entry
-            const pruned = pruneNestedDirectories(Array.from(dirValues));
-            collapsed[dirKey] = pruned.sort();
-        }
-        else {
-            // No directories found, keep as individual file entries
-            for (const entry of entries) {
-                collapsed[entry.key] = entry.values;
-            }
-        }
-    }
-    return sortMapping(collapsed);
-}
 /**
  * Build a mapping that preserves exact file keys for the provided packageFiles.
  * For universal subdirs, maps to platform-specific installed paths that ACTUALLY EXIST.
@@ -172,22 +121,27 @@ async function buildExactFileMapping(cwd, packageFiles, platforms) {
         const absPath = join(cwd, relPath);
         return await exists(absPath);
     };
+    const rootFileNames = getPlatformRootFileNames(platforms, cwd);
+    const explicitRootKeys = new Set();
+    const hasAgents = packageFiles.some(file => normalizeRegistryPath(file.path) === FILE_PATTERNS.AGENTS_MD);
     // First pass: record platform-specific target files keyed by base universal key
     for (const file of packageFiles) {
         const normalized = normalizeRegistryPath(file.path);
-        if (isRootRegistryPath(normalized))
+        if (isRootCopyPath(normalized))
+            continue;
+        if (isRootRegistryPath(normalized) || rootFileNames.has(normalized))
             continue;
-        if (isSkippableRegistryPath(normalized))
+        if (isSkippableRegistryPath(normalized, cwd))
             continue;
-        if (!isAllowedRegistryPath(normalized))
+        if (!isAllowedRegistryPath(normalized, cwd))
             continue;
         const parsed = parseUniversalPath(normalized);
         if (parsed && parsed.platformSuffix && isPlatformId(parsed.platformSuffix)) {
             try {
-                const { absFile } = mapUniversalToPlatform(parsed.platformSuffix, parsed.universalSubdir, parsed.relPath);
+                const { relFile } = mapUniversalToPlatform(parsed.platformSuffix, parsed.universalSubdir, parsed.relPath, cwd);
                 const baseKey = `${parsed.universalSubdir}/${parsed.relPath}`;
                 const set = platformSpecificTargetsByBase.get(baseKey) ?? new Set();
-                set.add(absFile.replace(/\\/g, '/'));
+                set.add(relFile.replace(/\\/g, '/'));
                 platformSpecificTargetsByBase.set(baseKey, set);
             }
             catch {
@@ -198,21 +152,37 @@ async function buildExactFileMapping(cwd, packageFiles, platforms) {
     // Second pass: build exact mappings, only including paths that actually exist
     for (const file of packageFiles) {
         const normalized = normalizeRegistryPath(file.path);
-        if (isRootRegistryPath(normalized))
-            continue;
-        if (isSkippableRegistryPath(normalized))
-            continue;
-        if (!isAllowedRegistryPath(normalized))
+        if (isSkippableRegistryPath(normalized, cwd))
             continue;
         const key = normalized.replace(/\\/g, '/');
         const values = new Set();
+        // Copy-to-root: root/** → strip prefix in workspace
+        const stripped = stripRootCopyPrefix(key);
+        if (stripped !== null) {
+            if (await checkExists(stripped)) {
+                values.add(stripped);
+            }
+            addTargets(key, values);
+            continue;
+        }
+        // Root files: store at workspace root with same name; AGENTS.md may also populate platform root files
+        if (rootFileNames.has(key) || isRootRegistryPath(key)) {
+            explicitRootKeys.add(key);
+            if (await checkExists(key)) {
+                values.add(key);
+            }
+            addTargets(key, values);
+            continue;
+        }
+        if (!isAllowedRegistryPath(normalized, cwd))
+            continue;
         const parsed = parseUniversalPath(key);
         if (parsed) {
             if (parsed.platformSuffix && isPlatformId(parsed.platformSuffix)) {
                 // Platform-specific registry key → only that platform target if it exists
                 try {
-                    const { absFile } = mapUniversalToPlatform(parsed.platformSuffix, parsed.universalSubdir, parsed.relPath);
-                    const relPath = absFile.replace(/\\/g, '/');
+                    const { relFile } = mapUniversalToPlatform(parsed.platformSuffix, parsed.universalSubdir, parsed.relPath, cwd);
+                    const relPath = relFile.replace(/\\/g, '/');
                     if (await checkExists(relPath)) {
                         values.add(relPath);
                     }
@@ -225,8 +195,8 @@ async function buildExactFileMapping(cwd, packageFiles, platforms) {
                 // Universal registry key → only include platform paths that actually exist
                 for (const platform of platforms) {
                     try {
-                        const { absFile } = mapUniversalToPlatform(platform, parsed.universalSubdir, parsed.relPath);
-                        const relPath = absFile.replace(/\\/g, '/');
+                        const { relFile } = mapUniversalToPlatform(platform, parsed.universalSubdir, parsed.relPath, cwd);
+                        const relPath = relFile.replace(/\\/g, '/');
                         if (await checkExists(relPath)) {
                             values.add(relPath);
                         }
@@ -235,6 +205,12 @@ async function buildExactFileMapping(cwd, packageFiles, platforms) {
                         // Ignore unsupported platforms
                     }
                 }
+                // Also record the workspace-relative key itself when it exists.
+                // This is important for root packages (and add flows) where the source path may be the only
+                // concrete workspace location before any apply/install expansion.
+                if (await checkExists(key)) {
+                    values.add(key);
+                }
                 // Prune: if platform-specific keys exist for this base, remove their targets from universal
                 const baseKey = `${parsed.universalSubdir}/${parsed.relPath}`;
                 const covered = platformSpecificTargetsByBase.get(baseKey);
@@ -253,22 +229,45 @@ async function buildExactFileMapping(cwd, packageFiles, platforms) {
         }
         addTargets(key, values);
     }
+    // If AGENTS.md exists in the package and platform root files exist in the workspace (without explicit overrides),
+    // record them as installed paths for AGENTS.md.
+    if (hasAgents) {
+        const values = new Set(mapping[FILE_PATTERNS.AGENTS_MD] ?? []);
+        for (const rootFile of rootFileNames) {
+            if (rootFile === FILE_PATTERNS.AGENTS_MD)
+                continue;
+            if (explicitRootKeys.has(rootFile))
+                continue;
+            if (await checkExists(rootFile)) {
+                values.add(rootFile);
+            }
+        }
+        addTargets(FILE_PATTERNS.AGENTS_MD, values);
+    }
     return mapping;
 }
 export async function buildMappingAndWriteIndex(cwd, packageContext, packageFiles, platforms, options = {}) {
     const packageName = packageContext.name;
     const packageLocation = packageContext.location;
     try {
-        // Filter to index-eligible files only (excludes package.yml, package index file, etc.)
+        // Filter to index-eligible files only (excludes openpackage.yml, package index file, etc.)
         // These are manifest/metadata files that are NOT synced to workspace locations
         const indexEligibleFiles = packageFiles.filter(f => {
             const normalized = normalizeRegistryPath(f.path);
-            return isAllowedRegistryPath(normalized) && !isSkippableRegistryPath(normalized);
+            if (isSkippableRegistryPath(normalized, cwd))
+                return false;
+            if (isAllowedRegistryPath(normalized, cwd))
+                return true;
+            if (isRootRegistryPath(normalized))
+                return true;
+            if (isRootCopyPath(normalized))
+                return true;
+            return false;
         });
         // Read existing index and other indexes for conflict context
         const previousIndex = await readPackageIndex(cwd, packageName, packageLocation);
         const otherIndexes = await loadOtherPackageIndexes(cwd, packageName);
-        // Resolve version (prefer previous index; otherwise read from package.yml)
+        // Resolve version (prefer previous index; otherwise read from openpackage.yml)
         let version = options.versionOverride || previousIndex?.workspace?.version || undefined;
         if (!version) {
             const packageYmlPath = packageContext.packageYmlPath;
@@ -278,7 +277,7 @@ export async function buildMappingAndWriteIndex(cwd, packageContext, packageFile
                     version = packageYml.version;
                 }
                 catch (error) {
-                    logger.warn(`Failed to read package.yml for version: ${error}`);
+                    logger.warn(`Failed to read openpackage.yml for version: ${error}`);
                     return;
                 }
             }
@@ -315,10 +314,10 @@ export async function buildMappingAndWriteIndex(cwd, packageContext, packageFile
             files: mergedFiles
         };
         await writePackageIndex(indexRecord);
-        logger.debug(`Updated ${FILE_PATTERNS.PACKAGE_INDEX_YML} for ${packageName}@${version}`);
+        logger.debug(`Updated ${FILE_PATTERNS.OPENPACKAGE_INDEX_YML} for ${packageName}@${version}`);
     }
     catch (error) {
-        logger.warn(`Failed to update ${FILE_PATTERNS.PACKAGE_INDEX_YML} for ${packageName}: ${error}`);
+        logger.warn(`Failed to update ${FILE_PATTERNS.OPENPACKAGE_INDEX_YML} for ${packageName}: ${error}`);
     }
 }
 //# sourceMappingURL=package-index-updater.js.map