opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/package-context.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Unified Package Context
+ *
+ * Provides consistent package location resolution for all pipelines.
+ * Package payloads store content at the package root alongside openpackage.yml.
+ * Cached packages (workspace) live under .openpackage/packages/<name>/ with the same layout.
+ */
+import type { PackageYml } from '../types/index.js';
+/**
+ * Package location type
+ */
+export type PackageLocation = 'root' | 'nested';
+/**
+ * Unified package context used by all pipelines.
+ *
+ * Key distinction:
+ * - packageRootDir: the package root directory (content lives directly here)
+ * - packageYmlPath: <packageRootDir>/openpackage.yml
+ *
+ * For root packages:
+ *   packageRootDir = cwd/
+ *   packageYmlPath = cwd/openpackage.yml
+ *
+ * For cached packages:
+ *   packageRootDir = cwd/.openpackage/packages/<name>/
+ *   packageYmlPath = cwd/.openpackage/packages/<name>/openpackage.yml
+ */
+export interface PackageContext {
+    /** Normalized package name */
+    name: string;
+    /** Package version from openpackage.yml */
+    version?: string;
+    /** Full config from openpackage.yml */
+    config: PackageYml;
+    /** Absolute path to openpackage.yml */
+    packageYmlPath: string;
+    /**
+     * Absolute path to the package root directory.
+     * - Root: <cwd>/
+     * - Nested: <cwd>/.openpackage/packages/<name>/
+     */
+    packageRootDir: string;
+    /**
+     * Absolute path to the content directory (same as package root for v2 layout)
+     */
+    packageFilesDir: string;
+    /** Package location type */
+    location: PackageLocation;
+    /** Whether this is the cwd's own package (root package without explicit name) */
+    isCwdPackage: boolean;
+    /** Whether this package was newly created (for init/add flows) */
+    isNew?: boolean;
+}
+/**
+ * Get the package root directory based on location.
+ * - Root: cwd/
+ * - Nested: cwd/.openpackage/packages/<name>/
+ */
+export declare function getPackageRootDir(cwd: string, location: PackageLocation, packageName?: string): string;
+/**
+ * Get the package content directory (v2 layout: same as the package root).
+ */
+export declare function getPackageFilesDir(cwd: string, location: PackageLocation, packageName?: string): string;
+/**
+ * Get the openpackage.yml path based on location.
+ */
+export declare function getPackageYmlPath(cwd: string, location: PackageLocation, packageName?: string): string;
+/**
+ * Core rule: any directory that contains `openpackage.yml` is a valid package.
+ */
+export declare function isValidPackageDirectory(dir: string): Promise<boolean>;
+/**
+ * Load package config from a directory that satisfies the core rule.
+ */
+export declare function loadPackageConfig(dir: string): Promise<PackageYml | null>;
+/**
+ * Detect package context for any pipeline operation.
+ *
+ * Resolution order:
+ * 1. No packageName provided → target cwd as root package
+ * 2. packageName matches root package name → root package
+ * 3. packageName found in nested packages → nested package
+ * 4. packageName not found → null (caller decides: error or create)
+ */
+export declare function detectPackageContext(cwd: string, packageName?: string): Promise<PackageContext | null>;
+/**
+ * Create a new package context for initialization.
+ * Does not write any files - just builds the context.
+ */
+export declare function createPackageContext(cwd: string, config: PackageYml, location: PackageLocation): PackageContext;
+/**
+ * Check if a package context represents a root package.
+ */
+export declare function isRootPackage(ctx: PackageContext): boolean;
+/**
+ * Error message for when no package is detected.
+ */
+export declare function getNoPackageDetectedMessage(packageName?: string): string;
+//# sourceMappingURL=package-context.d.ts.map

package/packages/core/dist/core/package-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-context.d.ts","sourceRoot":"","sources":["../../src/core/package-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAC;IAEnB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAE1B,iFAAiF;IACjF,YAAY,EAAE,OAAO,CAAC;IAEtB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtG;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAY/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAiHhC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,eAAe,GACxB,cAAc,CAchB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBxE"}

package/packages/core/dist/core/package-context.js

@@ -0,0 +1,220 @@
+/**
+ * Unified Package Context
+ *
+ * Provides consistent package location resolution for all pipelines.
+ * Package payloads store content at the package root alongside openpackage.yml.
+ * Cached packages (workspace) live under .openpackage/packages/<name>/ with the same layout.
+ */
+import { join } from 'path';
+import { DIR_PATTERNS, FILE_PATTERNS, OPENPACKAGE_DIRS } from '../constants/index.js';
+import { exists, isDirectory } from '../utils/fs.js';
+import { parsePackageYml } from '../utils/package-yml.js';
+import { arePackageNamesEquivalent, normalizePackageName } from '../utils/package-name.js';
+import { findDirectoriesContainingFile } from '../utils/file-processing.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Get the package root directory based on location.
+ * - Root: cwd/
+ * - Nested: cwd/.openpackage/packages/<name>/
+ */
+export function getPackageRootDir(cwd, location, packageName) {
+    if (location === 'root') {
+        return cwd;
+    }
+    if (!packageName) {
+        throw new Error('Package name required for nested packages');
+    }
+    return join(cwd, DIR_PATTERNS.OPENPACKAGE, OPENPACKAGE_DIRS.PACKAGES, normalizePackageName(packageName));
+}
+/**
+ * Get the package content directory (v2 layout: same as the package root).
+ */
+export function getPackageFilesDir(cwd, location, packageName) {
+    // In v2, content lives at the package root.
+    return getPackageRootDir(cwd, location, packageName);
+}
+/**
+ * Get the openpackage.yml path based on location.
+ */
+export function getPackageYmlPath(cwd, location, packageName) {
+    const contentDir = getPackageRootDir(cwd, location, packageName);
+    return join(contentDir, FILE_PATTERNS.OPENPACKAGE_YML);
+}
+/**
+ * Core rule: any directory that contains `openpackage.yml` is a valid package.
+ */
+export async function isValidPackageDirectory(dir) {
+    const packageYmlPath = join(dir, FILE_PATTERNS.OPENPACKAGE_YML);
+    return exists(packageYmlPath);
+}
+/**
+ * Load package config from a directory that satisfies the core rule.
+ */
+export async function loadPackageConfig(dir) {
+    const packageYmlPath = join(dir, FILE_PATTERNS.OPENPACKAGE_YML);
+    if (!(await exists(packageYmlPath))) {
+        return null;
+    }
+    try {
+        return await parsePackageYml(packageYmlPath);
+    }
+    catch (error) {
+        logger.debug(`Failed to parse openpackage.yml at ${packageYmlPath}: ${error}`);
+        return null;
+    }
+}
+/**
+ * Detect package context for any pipeline operation.
+ *
+ * Resolution order:
+ * 1. No packageName provided → target cwd as root package
+ * 2. packageName matches root package name → root package
+ * 3. packageName found in nested packages → nested package
+ * 4. packageName not found → null (caller decides: error or create)
+ */
+export async function detectPackageContext(cwd, packageName) {
+    const rootPackageYmlPath = getPackageYmlPath(cwd, 'root');
+    const hasRootPackage = await exists(rootPackageYmlPath);
+    // No package name provided: target cwd as the package itself
+    if (!packageName) {
+        if (!hasRootPackage) {
+            return null;
+        }
+        try {
+            const config = await parsePackageYml(rootPackageYmlPath);
+            return {
+                name: normalizePackageName(config.name),
+                version: config.version,
+                config,
+                packageYmlPath: rootPackageYmlPath,
+                packageRootDir: getPackageRootDir(cwd, 'root'),
+                packageFilesDir: getPackageFilesDir(cwd, 'root'),
+                location: 'root',
+                isCwdPackage: true
+            };
+        }
+        catch (error) {
+            logger.warn(`Failed to parse root openpackage.yml: ${error}`);
+            return null;
+        }
+    }
+    const normalizedName = normalizePackageName(packageName);
+    // Package name provided: check if it matches root package
+    if (hasRootPackage) {
+        try {
+            const rootConfig = await parsePackageYml(rootPackageYmlPath);
+            if (arePackageNamesEquivalent(rootConfig.name, packageName)) {
+                return {
+                    name: normalizedName,
+                    version: rootConfig.version,
+                    config: rootConfig,
+                    packageYmlPath: rootPackageYmlPath,
+                    packageRootDir: getPackageRootDir(cwd, 'root'),
+                    packageFilesDir: getPackageFilesDir(cwd, 'root'),
+                    location: 'root',
+                    isCwdPackage: true
+                };
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse root openpackage.yml: ${error}`);
+        }
+    }
+    // Check nested packages directory
+    // Check cached packages directory for a matching package name
+    const packagesDir = join(cwd, DIR_PATTERNS.OPENPACKAGE, OPENPACKAGE_DIRS.PACKAGES);
+    if (await exists(packagesDir) && (await isDirectory(packagesDir))) {
+        try {
+            // Direct match on expected path
+            const nestedPackageRootDir = getPackageRootDir(cwd, 'nested', packageName);
+            const nestedPackageYmlPath = getPackageYmlPath(cwd, 'nested', packageName);
+            if (await exists(nestedPackageYmlPath)) {
+                const nestedConfig = await parsePackageYml(nestedPackageYmlPath);
+                if (arePackageNamesEquivalent(nestedConfig.name, packageName)) {
+                    return {
+                        name: normalizedName,
+                        version: nestedConfig.version,
+                        config: nestedConfig,
+                        packageYmlPath: nestedPackageYmlPath,
+                        packageRootDir: nestedPackageRootDir,
+                        packageFilesDir: nestedPackageRootDir,
+                        location: 'nested',
+                        isCwdPackage: false
+                    };
+                }
+            }
+            // Fallback: scan for mismatched directory name
+            const packageDirs = await findDirectoriesContainingFile(packagesDir, FILE_PATTERNS.OPENPACKAGE_YML, async (filePath) => {
+                try {
+                    return await parsePackageYml(filePath);
+                }
+                catch {
+                    return null;
+                }
+            });
+            for (const { dirPath, parsedContent } of packageDirs) {
+                if (!parsedContent)
+                    continue;
+                if (arePackageNamesEquivalent(parsedContent.name, packageName)) {
+                    // dirPath is the package root containing openpackage.yml
+                    const packageRootDir = dirPath;
+                    return {
+                        name: normalizedName,
+                        version: parsedContent.version,
+                        config: parsedContent,
+                        packageYmlPath: join(dirPath, FILE_PATTERNS.OPENPACKAGE_YML),
+                        packageRootDir,
+                        packageFilesDir: packageRootDir,
+                        location: 'nested',
+                        isCwdPackage: false
+                    };
+                }
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to scan packages directory: ${error}`);
+        }
+    }
+    return null;
+}
+/**
+ * Create a new package context for initialization.
+ * Does not write any files - just builds the context.
+ */
+export function createPackageContext(cwd, config, location) {
+    const normalizedName = normalizePackageName(config.name);
+    return {
+        name: normalizedName,
+        version: config.version,
+        config,
+        packageYmlPath: getPackageYmlPath(cwd, location, location === 'nested' ? normalizedName : undefined),
+        packageRootDir: getPackageRootDir(cwd, location, location === 'nested' ? normalizedName : undefined),
+        packageFilesDir: getPackageFilesDir(cwd, location, location === 'nested' ? normalizedName : undefined),
+        location,
+        isCwdPackage: location === 'root',
+        isNew: true
+    };
+}
+/**
+ * Check if a package context represents a root package.
+ */
+export function isRootPackage(ctx) {
+    return ctx.location === 'root';
+}
+/**
+ * Error message for when no package is detected.
+ */
+export function getNoPackageDetectedMessage(packageName) {
+    if (packageName) {
+        return (`Package '${packageName}' not found.\n\n` +
+            `Checked locations:\n` +
+            `  • Root package: openpackage.yml\n` +
+            `  • Cached packages: .openpackage/packages/${packageName}/\n\n` +
+            `💡 To install a package, run: opkg install ${packageName}`);
+    }
+    return (`No package detected at current directory.\n\n` +
+        `A valid package requires openpackage.yml to exist.\n\n` +
+        `💡 To create a package:\n` +
+        `   • Run 'opkg new' to create a new package`);
+}
+//# sourceMappingURL=package-context.js.map

package/packages/core/dist/core/package-context.js.map

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

package/packages/core/dist/core/package-creation.d.ts

@@ -0,0 +1,45 @@
+import type { PackageScope } from './scope-resolution.js';
+import type { PackageContext } from './package-context.js';
+import type { OutputPort } from './ports/output.js';
+/**
+ * Options for creating a new package
+ */
+export interface CreatePackageOptions {
+    /** Current working directory */
+    cwd: string;
+    /** Package scope (root, project, or global) - optional when customPath is provided */
+    scope?: PackageScope;
+    /** Custom directory path for package - overrides scope-based resolution */
+    customPath?: string;
+    /** Package name (optional for root scope, required for project/global) */
+    packageName?: string;
+    /** Force overwrite existing package */
+    force?: boolean;
+}
+/**
+ * Result of package creation
+ */
+export interface CreatePackageResult {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Package context if successful */
+    context?: PackageContext;
+    /** Error message if unsuccessful */
+    error?: string;
+    /** Whether the package already existed (and was kept/overwritten) */
+    wasExisting?: boolean;
+}
+/**
+ * Create a new package with the specified scope and options
+ *
+ * This is the core package creation logic that handles:
+ * - Validation of package name and scope
+ * - Conflict detection with existing packages
+ * - Directory structure creation
+ * - openpackage.yml writing
+ *
+ * @param options - Package creation options
+ * @returns Result containing success status and package context
+ */
+export declare function createPackage(options: CreatePackageOptions, output?: OutputPort): Promise<CreatePackageResult>;
+//# sourceMappingURL=package-creation.d.ts.map

package/packages/core/dist/core/package-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-creation.d.ts","sourceRoot":"","sources":["../../src/core/package-creation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiB1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,sFAAsF;IACtF,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAgK9B"}

package/packages/core/dist/core/package-creation.js

@@ -0,0 +1,160 @@
+import { basename } from 'path';
+import { getScopePackageDir, getScopePackageYmlPath, getScopeDisplayPath, getScopeDescription } from './scope-resolution.js';
+import { resolveCustomPath, validateCustomPath, formatCustomPathForDisplay } from '../utils/custom-path-resolution.js';
+import { parsePackageYml, writePackageYml } from '../utils/package-yml.js';
+import { logger } from '../utils/logger.js';
+import { displayPackageConfig } from '../utils/formatters.js';
+import { exists, ensureDir } from '../utils/fs.js';
+import { normalizePackageName, validatePackageName } from '../utils/package-name.js';
+import { resolveOutput } from './ports/resolve.js';
+/**
+ * Create a new package with the specified scope and options
+ *
+ * This is the core package creation logic that handles:
+ * - Validation of package name and scope
+ * - Conflict detection with existing packages
+ * - Directory structure creation
+ * - openpackage.yml writing
+ *
+ * @param options - Package creation options
+ * @returns Result containing success status and package context
+ */
+export async function createPackage(options, output) {
+    const out = output ?? resolveOutput();
+    const { cwd, scope, customPath, packageName, force = false } = options;
+    try {
+        // Validate that either scope or customPath is provided
+        if (!scope && !customPath) {
+            return {
+                success: false,
+                error: 'Either scope or customPath must be provided'
+            };
+        }
+        // Step 1: Determine initial package name
+        let normalizedName;
+        let displayName;
+        if (!packageName) {
+            // No name provided - package name is required for non-root scopes
+            if (scope && scope !== 'root' && !customPath) {
+                return {
+                    success: false,
+                    error: `Package name is required for ${scope} scope.\nUsage: opkg new <package-name> --scope ${scope}`
+                };
+            }
+            // Use cwd basename as default for root scope
+            displayName = basename(cwd);
+            normalizedName = normalizePackageName(displayName);
+        }
+        else {
+            // Package name provided
+            validatePackageName(packageName);
+            normalizedName = normalizePackageName(packageName);
+            displayName = packageName;
+        }
+        // Step 2: Resolve target paths
+        let packageDir;
+        let packageYmlPath;
+        let displayPath;
+        let isCustomPath = false;
+        if (customPath) {
+            // Custom path provided - resolve and validate
+            const resolved = resolveCustomPath(customPath, cwd);
+            // Validate custom path
+            const validation = await validateCustomPath(resolved, force);
+            if (!validation.valid) {
+                return {
+                    success: false,
+                    error: validation.error
+                };
+            }
+            // Log warning if present
+            if (validation.warning) {
+                logger.warn(validation.warning);
+            }
+            packageDir = resolved.absolute;
+            packageYmlPath = resolved.packageYmlPath;
+            displayPath = formatCustomPathForDisplay(resolved, cwd);
+            isCustomPath = true;
+            logger.info(`Creating package '${normalizedName}' at custom path: ${packageDir}`);
+        }
+        else if (scope) {
+            // Scope-based path resolution (existing logic)
+            packageDir = getScopePackageDir(cwd, scope, scope === 'root' ? undefined : normalizedName);
+            packageYmlPath = getScopePackageYmlPath(cwd, scope, scope === 'root' ? undefined : normalizedName);
+            displayPath = getScopeDisplayPath(scope, scope === 'root' ? undefined : normalizedName);
+            logger.info(`Creating ${scope} package '${normalizedName}' at: ${packageDir}`);
+        }
+        else {
+            return {
+                success: false,
+                error: 'Either scope or customPath must be provided'
+            };
+        }
+        // Step 3: Check for existing package
+        const existingYml = await exists(packageYmlPath);
+        let existingConfig = null;
+        if (existingYml) {
+            try {
+                existingConfig = await parsePackageYml(packageYmlPath);
+            }
+            catch (error) {
+                logger.warn(`Failed to parse existing openpackage.yml: ${error}`);
+            }
+            if (!force) {
+                const errorMsg = existingConfig
+                    ? `Package '${normalizedName}' already exists at ${displayPath}. Use --force to overwrite.`
+                    : `Package already exists at ${displayPath}. Use --force to overwrite.`;
+                return {
+                    success: false,
+                    error: errorMsg,
+                    wasExisting: true
+                };
+            }
+            logger.info(`Overwriting existing package at ${displayPath} (--force enabled)`);
+        }
+        // Step 4: Create package config (minimal manifest)
+        const packageConfig = {
+            name: normalizedName
+        };
+        // Step 5: Ensure directory structure
+        await ensureDir(packageDir);
+        logger.debug(`Created package directory: ${packageDir}`);
+        // Step 6: Write openpackage.yml
+        await writePackageYml(packageYmlPath, packageConfig);
+        logger.info(`Created openpackage.yml at ${packageYmlPath}`);
+        // Step 7: Display success message
+        displayPackageConfig(packageConfig, packageYmlPath, false);
+        // Step 8: Show scope info
+        if (isCustomPath) {
+            out.message(`  Location: Custom path (${displayPath})`);
+        }
+        else if (scope) {
+            out.message(`  Scope: ${getScopeDescription(scope)}`);
+        }
+        // Step 9: Return success with context
+        return {
+            success: true,
+            context: {
+                name: normalizedName,
+                version: packageConfig.version,
+                config: packageConfig,
+                packageYmlPath,
+                packageRootDir: packageDir,
+                packageFilesDir: packageDir,
+                location: (isCustomPath || (scope && scope === 'root')) ? 'root' : 'nested',
+                isCwdPackage: !isCustomPath && scope === 'root',
+                isNew: !existingYml
+            },
+            wasExisting: existingYml
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to create package`, { error: errorMessage, scope, packageName });
+        return {
+            success: false,
+            error: `Failed to create package: ${errorMessage}`
+        };
+    }
+}
+//# sourceMappingURL=package-creation.js.map

package/packages/core/dist/core/package-creation.js.map

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

package/packages/core/dist/core/package-management.d.ts

@@ -0,0 +1,70 @@
+import { PackageYml } from '../types/index.js';
+import type { OutputPort } from './ports/output.js';
+import type { PromptPort } from './ports/prompt.js';
+/**
+ * Ensure local OpenPackage directory structure exists
+ * Shared utility for both install and save commands
+ */
+export declare function ensureLocalOpenPackageStructure(targetDir: string): Promise<void>;
+/**
+ * Create a basic openpackage.yml file for workspace if it doesn't exist
+ * Shared utility for both install and save commands
+ * @param force - If true, overwrite existing openpackage.yml
+ * @returns the openpackage.yml if it was created, null if it already existed and force=false
+ */
+export declare function createWorkspacePackageYml(targetDir: string, force?: boolean, output?: OutputPort): Promise<PackageYml | null>;
+export interface EnsurePackageWithYmlOptions {
+    interactive?: boolean;
+    defaultVersion?: string;
+}
+export interface EnsurePackageWithYmlResult {
+    normalizedName: string;
+    packageDir: string;
+    packageYmlPath: string;
+    packageConfig: PackageYml;
+    isNew: boolean;
+}
+/**
+ * Ensure a cached package directory and openpackage.yml exist, optionally prompting for details.
+ * This is for NESTED packages only. Root packages use different flow.
+ */
+export declare function ensurePackageWithYml(targetDir: string, packageName: string, options?: EnsurePackageWithYmlOptions, output?: OutputPort, prompt?: PromptPort): Promise<EnsurePackageWithYmlResult>;
+/**
+ * Add a package dependency to openpackage.yml with smart placement logic
+ * Shared utility for both install and save commands
+ */
+export declare function addPackageToYml(targetDir: string, packageName: string, packageVersion: string | undefined, isDev?: boolean, originalVersion?: string, // The original version/range that was requested
+silent?: boolean, path?: string, // Path to local directory or tarball (for path-based dependencies)
+git?: string, // Git source url (DEPRECATED: use url) (mutually exclusive with path/version)
+ref?: string, // Git ref (DEPRECATED: embed in url as #ref)
+gitPath?: string, // Git subdirectory path (for plugins in marketplaces)
+base?: string, // Phase 4: Base field for resource model
+output?: OutputPort): Promise<void>;
+/**
+ * Remove a dependency entry from a manifest file (both dependencies and dev-dependencies).
+ * Use this when removing from a specific package manifest (e.g. --from essentials).
+ *
+ * @param manifestPath - Absolute path to openpackage.yml
+ * @param dependencyName - User-specified name to match (e.g. essential-agent, @scope/pkg)
+ * @returns true if a dependency was removed, false otherwise
+ */
+export interface RemoveDependencyFromManifestResult {
+    removed: boolean;
+    section?: 'dependencies' | 'dev-dependencies';
+}
+export declare function removeDependencyFromManifest(manifestPath: string, dependencyName: string): Promise<RemoveDependencyFromManifestResult>;
+/**
+ * Remove a dependency entry from openpackage.yml (both dependencies and dev-dependencies).
+ * Operates on the workspace manifest at .openpackage/openpackage.yml
+ */
+export declare function removePackageFromOpenpackageYml(targetDir: string, packageName: string): Promise<boolean>;
+/**
+ * Check if a manifest contains a dependency matching the user input.
+ * Uses context-aware matching (direct name, git variations, etc.).
+ *
+ * @param manifestPath - Absolute path to openpackage.yml
+ * @param userInput - User-specified name (e.g. essential-agent, .opencode)
+ * @returns The matched dependency's stored name if found, null otherwise
+ */
+export declare function findMatchingDependencyInManifest(manifestPath: string, userInput: string): Promise<string | null>;
+//# sourceMappingURL=package-management.d.ts.map

package/packages/core/dist/core/package-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-management.d.ts","sourceRoot":"","sources":["../../src/core/package-management.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAqB,MAAM,mBAAmB,CAAC;AAYlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtF;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA0B1I;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,UAAU,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,2BAAgC,EACzC,MAAM,CAAC,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,0BAA0B,CAAC,CAqFrC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,GAAE,OAAe,EACtB,eAAe,CAAC,EAAE,MAAM,EAAE,gDAAgD;AAC1E,MAAM,GAAE,OAAe,EACvB,IAAI,CAAC,EAAE,MAAM,EAAG,mEAAmE;AACnF,GAAG,CAAC,EAAE,MAAM,EAAI,8EAA8E;AAC9F,GAAG,CAAC,EAAE,MAAM,EAAI,6CAA6C;AAC7D,OAAO,CAAC,EAAE,MAAM,EAAG,sDAAsD;AACzE,IAAI,CAAC,EAAE,MAAM,EAAG,yCAAyC;AACzD,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA6If;AAgFD;;;;;;;GAOG;AACH,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,GAAG,kBAAkB,CAAC;CAC/C;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kCAAkC,CAAC,CAqC7C;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB"}