opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/directory.js

@@ -0,0 +1,203 @@
+import * as os from 'os';
+import * as path from 'path';
+import * as semver from 'semver';
+import { DIR_PATTERNS, OPENPACKAGE_DIRS, UNVERSIONED } from '../constants/index.js';
+import { ensureDir, exists, listDirectories, remove } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+import { normalizePackageName } from '../utils/package-name.js';
+/**
+ * Cross-platform directory resolution following platform conventions
+ */
+/**
+ * Get OpenPackage directories using unified dotfile convention
+ * Uses ~/.openpackage on all platforms for consistency (like AWS CLI with ~/.aws)
+ * This approach prioritizes simplicity and cross-platform consistency
+ */
+export function getOpenPackageDirectories() {
+    const homeDir = os.homedir();
+    const openPackageDir = path.join(homeDir, DIR_PATTERNS.OPENPACKAGE);
+    return {
+        config: openPackageDir,
+        data: openPackageDir, // Same directory - follows dotfile convention
+        cache: path.join(openPackageDir, OPENPACKAGE_DIRS.CACHE),
+        runtime: path.join(os.tmpdir(), 'openpackage')
+    };
+}
+/**
+ * Ensure all OpenPackage directories exist
+ */
+export async function ensureOpenPackageDirectories() {
+    const openPackageDirs = getOpenPackageDirectories();
+    try {
+        await Promise.all([
+            ensureDir(openPackageDirs.config),
+            ensureDir(openPackageDirs.data),
+            ensureDir(openPackageDirs.cache),
+            ensureDir(openPackageDirs.runtime)
+        ]);
+        logger.debug('OpenPackage directories ensured', { directories: openPackageDirs });
+        return openPackageDirs;
+    }
+    catch (error) {
+        logger.error('Failed to create OpenPackage directories', { error, directories: openPackageDirs });
+        throw error;
+    }
+}
+/**
+ * Get the registry directories
+ */
+export function getRegistryDirectories() {
+    const openPackageDirs = getOpenPackageDirectories();
+    const registryDir = path.join(openPackageDirs.data, OPENPACKAGE_DIRS.REGISTRY);
+    return {
+        packages: registryDir
+    };
+}
+/**
+ * Ensure registry directories exist
+ */
+export async function ensureRegistryDirectories() {
+    const dirs = getRegistryDirectories();
+    try {
+        await ensureDir(dirs.packages);
+        logger.debug('Registry directories ensured', { directories: dirs });
+        return dirs;
+    }
+    catch (error) {
+        logger.error('Failed to create registry directories', { error, directories: dirs });
+        throw error;
+    }
+}
+/**
+ * Get the cache directory for a specific type of cache
+ */
+export function getCacheDirectory(cacheType) {
+    const openPackageDirs = getOpenPackageDirectories();
+    return path.join(openPackageDirs.cache, cacheType);
+}
+/**
+ * Get the temporary directory for a specific operation
+ */
+export function getTempDirectory(operation) {
+    const openPackageDirs = getOpenPackageDirectories();
+    return path.join(openPackageDirs.runtime, operation);
+}
+/**
+ * Get the base path for a package (contains all versions)
+ * Package names are normalized to lowercase for consistent registry paths.
+ */
+export function getPackagePath(packageName) {
+    const dirs = getRegistryDirectories();
+    const normalizedName = normalizePackageName(packageName);
+    return path.join(dirs.packages, normalizedName);
+}
+/**
+ * Get the path for a specific version of a package
+ * If version is undefined, return the unversioned path.
+ */
+export function getPackageVersionPath(packageName, version) {
+    const versionSegment = version ?? UNVERSIONED;
+    return path.join(getPackagePath(packageName), versionSegment);
+}
+/**
+ * List all versions of a package
+ */
+export async function listPackageVersions(packageName) {
+    const packagePath = getPackagePath(packageName);
+    if (!(await exists(packagePath))) {
+        return [];
+    }
+    const versions = await listDirectories(packagePath);
+    const semverVersions = versions.filter(version => semver.valid(version));
+    return semverVersions.sort((a, b) => semver.compare(b, a)); // Latest first
+}
+/**
+ * Get the latest version of a package
+ */
+export async function getLatestPackageVersion(packageName) {
+    const versions = await listPackageVersions(packageName);
+    if (versions.length === 0) {
+        return null;
+    }
+    return versions[0];
+}
+/**
+ * Check if a specific version exists
+ */
+export async function hasPackageVersion(packageName, version) {
+    const versionPath = getPackageVersionPath(packageName, version);
+    return await exists(versionPath);
+}
+/**
+ * Find a package by name, searching case-insensitively across registry directories.
+ * Returns the normalized package name if found, null otherwise.
+ * If multiple packages match the same normalized name, returns the first one found.
+ */
+export async function findPackageByName(packageName) {
+    const normalizedTarget = normalizePackageName(packageName);
+    const dirs = getRegistryDirectories();
+    if (!(await exists(dirs.packages))) {
+        return null;
+    }
+    const packageDirs = await listDirectories(dirs.packages);
+    // First try exact normalized match
+    if (packageDirs.includes(normalizedTarget)) {
+        return normalizedTarget;
+    }
+    // Then try case-insensitive match
+    for (const dirName of packageDirs) {
+        if (normalizePackageName(dirName) === normalizedTarget) {
+            return dirName; // Return the actual directory name as it exists on disk
+        }
+    }
+    return null;
+}
+/**
+ * List all package base names in the local registry, including scoped packages.
+ * Returns names relative to the packages root, e.g. 'name', '@scope/name', or '@scope/name/subname'.
+ * Supports arbitrary nesting for hierarchical package names.
+ */
+export async function listAllPackages() {
+    const { packages } = getRegistryDirectories();
+    if (!(await exists(packages))) {
+        return [];
+    }
+    const result = [];
+    /**
+     * Recursively scan for packages by checking for version directories
+     */
+    async function scanForPackages(currentPath, relativePath) {
+        const children = await listDirectories(currentPath);
+        // Check if this directory contains version directories (is a package)
+        const hasVersions = children.some(child => child === UNVERSIONED || semver.valid(child));
+        if (hasVersions) {
+            result.push(relativePath);
+            return; // Don't recurse into version directories
+        }
+        // Otherwise, recurse into subdirectories
+        for (const child of children) {
+            const childPath = path.join(currentPath, child);
+            const childRelativePath = relativePath ? `${relativePath}/${child}` : child;
+            await scanForPackages(childPath, childRelativePath);
+        }
+    }
+    await scanForPackages(packages, '');
+    // Stable order
+    result.sort((a, b) => a.localeCompare(b));
+    return result;
+}
+/**
+ * Clean up empty package directory after all versions are removed
+ * Returns true if directory was removed, false if it still has versions
+ */
+export async function cleanupEmptyPackageDirectory(packageName) {
+    const packagePath = getPackagePath(packageName);
+    const versions = await listPackageVersions(packageName);
+    if (versions.length === 0 && await exists(packagePath)) {
+        await remove(packagePath);
+        logger.info('Removed empty package directory', { packagePath });
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=directory.js.map

package/packages/core/dist/core/directory.js.map

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

package/packages/core/dist/core/discovery/file-discovery.d.ts

@@ -0,0 +1,17 @@
+import type { Platform } from '../platforms.js';
+import { DiscoveredFile } from '../../types/index.js';
+export interface DiscoveryPathContext {
+    platform?: Platform;
+    registryPathPrefix?: string;
+    sourceDirLabel?: string;
+    excludeDirs?: Set<string>;
+    /**
+     * Optional list of file extensions to consider when discovering files.
+     * - undefined -> include all files
+     * - [] -> include all files
+     * - ['.toml'] -> include only matching extensions
+     */
+    fileExtensions?: string[];
+}
+export declare function discoverFiles(rootDir: string, packageName: string, context: DiscoveryPathContext): Promise<DiscoveredFile[]>;
+//# sourceMappingURL=file-discovery.d.ts.map

package/packages/core/dist/core/discovery/file-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-discovery.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/file-discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAGD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CAgB3B"}

package/packages/core/dist/core/discovery/file-discovery.js

@@ -0,0 +1,61 @@
+import { join } from 'path';
+import { getPlatformDefinition, deriveRootDirFromFlows } from '../platforms.js';
+import { mapPlatformFileToUniversal } from '../platform/platform-mapper.js';
+import { exists, isDirectory, readTextFile } from '../../utils/fs.js';
+import { getFileMtime, findFilesByExtension } from '../../utils/file-processing.js';
+import { calculateFileHash } from '../../utils/hash-utils.js';
+import { logger } from '../../utils/logger.js';
+export async function discoverFiles(rootDir, packageName, context) {
+    if (!(await exists(rootDir)) || !(await isDirectory(rootDir))) {
+        return [];
+    }
+    const fileExtensions = context.fileExtensions ?? [];
+    const files = await findFilesByExtension(rootDir, fileExtensions, rootDir, {
+        excludeDirs: context.excludeDirs
+    });
+    const processPromises = files.map(async (file) => processFileForDiscovery(file, packageName, context));
+    const results = await Promise.all(processPromises);
+    return results.filter((result) => result !== null);
+}
+async function processFileForDiscovery(file, packageName, context) {
+    try {
+        const content = await readTextFile(file.fullPath);
+        try {
+            const mtime = await getFileMtime(file.fullPath);
+            const contentHash = await calculateFileHash(content);
+            const fallbackPath = context.registryPathPrefix
+                ? join(context.registryPathPrefix, file.relativePath)
+                : file.relativePath;
+            let sourceDir;
+            let registryPath;
+            if (context.platform) {
+                const mapping = mapPlatformFileToUniversal(file.fullPath);
+                registryPath = mapping
+                    ? join(mapping.subdir, mapping.relPath)
+                    : fallbackPath;
+                const platformDef = getPlatformDefinition(context.platform);
+                sourceDir = context.sourceDirLabel ?? deriveRootDirFromFlows(platformDef);
+            }
+            else {
+                sourceDir = context.sourceDirLabel ?? (context.registryPathPrefix || 'workspace');
+                registryPath = fallbackPath;
+            }
+            return {
+                fullPath: file.fullPath,
+                relativePath: file.relativePath,
+                sourceDir,
+                registryPath,
+                mtime,
+                contentHash
+            };
+        }
+        catch (error) {
+            logger.warn(`Failed to process file metadata for ${file.relativePath}: ${error}`);
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to read ${file.relativePath}: ${error}`);
+    }
+    return null;
+}
+//# sourceMappingURL=file-discovery.js.map

package/packages/core/dist/core/discovery/file-discovery.js.map

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

package/packages/core/dist/core/discovery/platform-files-discovery.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredFile } from '../../types/index.js';
+export declare function discoverPlatformFilesUnified(cwd: string, packageName: string): Promise<DiscoveredFile[]>;
+//# sourceMappingURL=platform-files-discovery.d.ts.map

package/packages/core/dist/core/discovery/platform-files-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-files-discovery.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/platform-files-discovery.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoG3D,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAgB9G"}

package/packages/core/dist/core/discovery/platform-files-discovery.js

@@ -0,0 +1,101 @@
+import { join } from 'path';
+import { exists, isDirectory } from '../../utils/fs.js';
+import { getPlatformDefinition, getDetectedPlatforms, isUniversalSubdirPath, deriveRootDirFromFlows } from '../../core/platforms.js';
+import { discoverFiles } from './file-discovery.js';
+import { normalizePathForProcessing } from '../../utils/path-normalization.js';
+import { WORKSPACE_DISCOVERY_EXCLUDES } from '../../constants/workspace.js';
+import { DIR_PATTERNS } from '../../constants/index.js';
+/**
+ * Process platform subdirectories (rules/commands/agents) within a base directory
+ * Uses flows to discover platform-specific directories
+ *
+ * TODO: Implement full flow-based discovery
+ * For now, discover all files under platform rootDir
+ */
+async function discoverPlatformFiles(cwd, platform, packageName) {
+    const definition = getPlatformDefinition(platform);
+    const allFiles = [];
+    // Discover files from export flows (package → workspace)
+    if (definition.export && definition.export.length > 0) {
+        // Extract unique directories from export flows 'to' patterns
+        const platformDirs = new Set();
+        for (const flow of definition.export) {
+            const toPattern = typeof flow.to === 'string' ? flow.to : Object.keys(flow.to)[0];
+            if (toPattern) {
+                // Extract directory from pattern (e.g., ".cursor/rules/{name}.mdc" -> "rules")
+                const parts = toPattern.split('/');
+                if (parts.length > 1) {
+                    // Get the directory component after rootDir
+                    const subdir = parts.slice(1, -1).join('/') || parts[1];
+                    if (subdir) {
+                        platformDirs.add(subdir);
+                    }
+                }
+            }
+        }
+        // Discover files in each platform directory
+        for (const subdir of platformDirs) {
+            const rootDir = deriveRootDirFromFlows(definition);
+            const subdirPath = join(cwd, rootDir, subdir);
+            if (await exists(subdirPath) && await isDirectory(subdirPath)) {
+                const files = await discoverFiles(subdirPath, packageName, {
+                    platform,
+                    registryPathPrefix: `${DIR_PATTERNS.OPENPACKAGE}/${subdir}`,
+                    sourceDirLabel: platform,
+                    fileExtensions: [] // Allow all extensions (flows handle filtering)
+                });
+                allFiles.push(...files);
+            }
+        }
+    }
+    return allFiles;
+}
+/**
+ * Dedupe discovered files by source fullPath, preferring universal subdirs over ai
+ */
+function dedupeDiscoveredFilesPreferUniversal(files) {
+    const preference = (file) => {
+        // Normalize registry path to use forward slashes for consistent comparison
+        const normalizedPath = normalizePathForProcessing(file.registryPath);
+        if (isUniversalSubdirPath(normalizedPath))
+            return 2;
+        return 1;
+    };
+    const map = new Map();
+    for (const file of files) {
+        const existing = map.get(file.fullPath);
+        if (!existing) {
+            map.set(file.fullPath, file);
+            continue;
+        }
+        if (preference(file) > preference(existing)) {
+            map.set(file.fullPath, file);
+        }
+    }
+    return Array.from(map.values());
+}
+/**
+ * Unified file discovery function that searches platform-specific directories
+ */
+async function discoverWorkspaceFiles(cwd, packageName) {
+    return await discoverFiles(cwd, packageName, {
+        registryPathPrefix: '',
+        sourceDirLabel: 'workspace',
+        excludeDirs: WORKSPACE_DISCOVERY_EXCLUDES,
+        fileExtensions: []
+    });
+}
+export async function discoverPlatformFilesUnified(cwd, packageName) {
+    const detectedPlatforms = await getDetectedPlatforms(cwd);
+    const allDiscoveredFiles = [];
+    // Process all platform configurations in parallel
+    const discoveryPromises = detectedPlatforms.map(async (platform) => {
+        return discoverPlatformFiles(cwd, platform, packageName);
+    });
+    const discoveredFiles = await Promise.all(discoveryPromises);
+    allDiscoveredFiles.push(...discoveredFiles.flat());
+    const workspaceDiscovered = await discoverWorkspaceFiles(cwd, packageName);
+    allDiscoveredFiles.push(...workspaceDiscovered);
+    return dedupeDiscoveredFilesPreferUniversal(allDiscoveredFiles);
+}
+//# sourceMappingURL=platform-files-discovery.js.map

package/packages/core/dist/core/discovery/platform-files-discovery.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * Execution Context Module
+ *
+ * Central module for all directory resolution logic.
+ * Creates and validates ExecutionContext for commands.
+ *
+ * This is the single source of truth for determining:
+ * - Where to resolve input arguments (sourceCwd)
+ * - Where to write output files (targetDir)
+ */
+import type { ExecutionContext, ExecutionOptions, ContextVariables } from '../types/execution-context.js';
+/**
+ * Create an ExecutionContext from command options.
+ *
+ * Priority logic:
+ * 1. If --global: targetDir = home directory
+ * 2. Else if --cwd: targetDir = resolve(cwd)
+ * 3. Else: targetDir = process.cwd()
+ *
+ * sourceCwd is always process.cwd() (original working directory)
+ *
+ * @param options - Command options (global, cwd flags)
+ * @returns Validated ExecutionContext
+ * @throws Error if validation fails
+ */
+export declare function createExecutionContext(options?: ExecutionOptions): Promise<ExecutionContext>;
+/**
+ * Generate context variables for platform flows and conditional logic.
+ *
+ * Variables:
+ * - $$targetRoot: Normalized target path (with ~/ if home)
+ * - $$sourceCwd: Original working directory
+ * - $$isGlobal: Global flag for convenience
+ *
+ * @param context - ExecutionContext
+ * @returns Map of context variables
+ */
+export declare function getContextVariables(context: ExecutionContext): ContextVariables;
+/**
+ * Get display-friendly target directory path.
+ * Shows ~/ for home directory.
+ *
+ * @param context - ExecutionContext
+ * @returns Display-friendly path
+ */
+export declare function getDisplayTargetDir(context: ExecutionContext): string;
+//# sourceMappingURL=execution-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/core/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAI1G;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8CtG;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAErE"}

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

@@ -0,0 +1,146 @@
+/**
+ * Execution Context Module
+ *
+ * Central module for all directory resolution logic.
+ * Creates and validates ExecutionContext for commands.
+ *
+ * This is the single source of truth for determining:
+ * - Where to resolve input arguments (sourceCwd)
+ * - Where to write output files (targetDir)
+ */
+import { resolve } from 'path';
+import { stat, access, constants as fsConstants } from 'fs/promises';
+import { getHomeDirectory, isHomeDirectory, normalizePathWithTilde } from '../utils/home-directory.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Create an ExecutionContext from command options.
+ *
+ * Priority logic:
+ * 1. If --global: targetDir = home directory
+ * 2. Else if --cwd: targetDir = resolve(cwd)
+ * 3. Else: targetDir = process.cwd()
+ *
+ * sourceCwd is always process.cwd() (original working directory)
+ *
+ * @param options - Command options (global, cwd flags)
+ * @returns Validated ExecutionContext
+ * @throws Error if validation fails
+ */
+export async function createExecutionContext(options = {}) {
+    // sourceCwd is always the original working directory
+    const sourceCwd = process.cwd();
+    // Determine targetDir based on options
+    let targetDir;
+    let isGlobal;
+    if (options.global) {
+        targetDir = getHomeDirectory();
+        isGlobal = true;
+        // Log warning if both flags present
+        if (options.cwd) {
+            logger.info('--global option present, ignoring --cwd', {
+                cwd: options.cwd,
+                targetDir
+            });
+        }
+    }
+    else if (options.cwd) {
+        targetDir = resolve(sourceCwd, options.cwd);
+        isGlobal = isHomeDirectory(targetDir);
+    }
+    else {
+        targetDir = sourceCwd;
+        isGlobal = isHomeDirectory(targetDir);
+    }
+    // Create context
+    const context = {
+        sourceCwd,
+        targetDir,
+        isGlobal,
+        interactive: options.interactive
+    };
+    // Validate context
+    await validateExecutionContext(context);
+    // Log context creation
+    logger.debug('Created execution context', {
+        sourceCwd: context.sourceCwd,
+        targetDir: context.targetDir,
+        isGlobal: context.isGlobal
+    });
+    return context;
+}
+/**
+ * Validate an ExecutionContext.
+ *
+ * Checks:
+ * - targetDir exists and is a directory
+ * - targetDir is writable
+ * - sourceCwd exists and is readable
+ *
+ * @param context - ExecutionContext to validate
+ * @throws Error with helpful message if validation fails
+ */
+async function validateExecutionContext(context) {
+    // Validate targetDir
+    try {
+        const targetStat = await stat(context.targetDir);
+        if (!targetStat.isDirectory()) {
+            throw new Error(`Target path is not a directory: ${context.targetDir}`);
+        }
+        // Check if writable
+        await access(context.targetDir, fsConstants.W_OK);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Target directory does not exist: ${context.targetDir}\n\n` +
+                `Hint: Create the directory or specify a different target with --cwd`);
+        }
+        if (error.code === 'EACCES') {
+            throw new Error(`Target directory is not writable: ${context.targetDir}\n\n` +
+                `Hint: Check directory permissions`);
+        }
+        throw new Error(`Invalid target directory: ${context.targetDir}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Validate sourceCwd
+    try {
+        const sourceStat = await stat(context.sourceCwd);
+        if (!sourceStat.isDirectory()) {
+            throw new Error(`Source working directory is not a directory: ${context.sourceCwd}`);
+        }
+        // Check if readable
+        await access(context.sourceCwd, fsConstants.R_OK);
+    }
+    catch (error) {
+        throw new Error(`Invalid source working directory: ${context.sourceCwd}\n` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Generate context variables for platform flows and conditional logic.
+ *
+ * Variables:
+ * - $$targetRoot: Normalized target path (with ~/ if home)
+ * - $$sourceCwd: Original working directory
+ * - $$isGlobal: Global flag for convenience
+ *
+ * @param context - ExecutionContext
+ * @returns Map of context variables
+ */
+export function getContextVariables(context) {
+    return {
+        $$targetRoot: normalizePathWithTilde(context.targetDir),
+        $$sourceCwd: context.sourceCwd,
+        $$isGlobal: context.isGlobal
+    };
+}
+/**
+ * Get display-friendly target directory path.
+ * Shows ~/ for home directory.
+ *
+ * @param context - ExecutionContext
+ * @returns Display-friendly path
+ */
+export function getDisplayTargetDir(context) {
+    return normalizePathWithTilde(context.targetDir);
+}
+//# sourceMappingURL=execution-context.js.map

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

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