zephyr-agent 0.0.0-canary-20250703033536 → 0.0.0-canary-20250728152440

package/README.md

@@ -95,6 +95,105 @@ interface ZephyrAgentConfig {
 }
 ```
 
+### Git Repository Requirements
+
+**IMPORTANT**: Zephyr requires a properly initialized Git repository with a remote origin for production deployments.
+
+#### Git Information Handling
+
+When Zephyr cannot find a Git repository with remote origin, it will:
+
+1. **Automatic Package.json-Based Naming**:
+
+   - Extract organization, project, and app names from your `package.json`
+   - Use authenticated user's username as the organization for personal Zephyr org
+   - Follow intelligent naming conventions based on package structure
+   - No user prompts or environment variables required
+
+2. **Enhanced Naming Logic**:
+   - **Scoped packages** (`@scope/name`): project = scope, app = name
+   - **With root package.json**:
+     - If root is scoped (`@scope/name`): project = scope, app = current package name
+     - Otherwise: project = root package name, app = current package name
+   - **Fallback to directory name**: If no root package.json found, uses directory name as project
+   - **Single package**: project = app = package name
+   - **Organization**: Uses authenticated user's username (sanitized for URL safety)
+
+#### Example Scenarios
+
+```bash
+# Recommended: Proper Git setup
+git init
+git remote add origin git@github.com:YOUR_ORG/YOUR_REPO.git
+git add . && git commit -m "Initial commit"
+npm run build  # Works perfectly with full Git context
+
+# Automatic fallback (works seamlessly)
+# No git repository - uses package.json naming
+npm run build  # Automatically determines naming from package.json
+
+# Examples of automatic naming:
+# package.json: { "name": "@my-company/my-app" }
+# → org: "jwt-username", project: "my-company", app: "my-app"
+
+# package.json: { "name": "my-project" } (no root package.json)
+# → org: "jwt-username", project: "my-project", app: "my-project"
+
+# package.json: { "name": "my-app" } (root package.json: { "name": "my-workspace" })
+# → org: "jwt-username", project: "my-workspace", app: "my-app"
+
+# package.json: { "name": "my-app" } (root package.json: { "name": "@company/monorepo" })
+# → org: "jwt-username", project: "company", app: "my-app"
+
+# package.json: { "name": "my-app" } (no root package.json found)
+# → org: "jwt-username", project: "current-directory-name", app: "my-app"
+
+# Special characters in username get sanitized:
+# Username: "Néstor López" → org: "n-stor-l-pez"
+```
+
+#### Why Git is Required
+
+Zephyr uses Git information to:
+
+- Determine organization and project structure
+- Track deployment versions and commits
+- Enable collaboration features
+- Provide proper deployment metadata
+
+Without Git, Zephyr cannot guarantee proper functionality, especially for:
+
+- Production deployments
+- Team collaboration
+- Version tracking
+- Rollback capabilities
+
+#### Package.json-Based Naming (Non-Git Environments)
+
+When Git is not available (e.g., AI coding tools, quick prototypes), Zephyr automatically extracts naming information from your `package.json` structure:
+
+**Automatic Organization Detection:**
+
+- Uses the authenticated user's name from your authentication token
+- Requires valid authentication to determine organization
+
+**Project and App Naming Logic:**
+
+1. **Scoped Package** (`@company/app-name`):
+
+   - Project: `company` (scope without @)
+   - App: `app-name`
+
+2. **Monorepo Structure** (root `package.json` exists):
+
+   - If root is scoped (`@company/monorepo`): Project = `company`, App = current package name
+   - Otherwise: Project = root package name, App = current package name
+   - If no root package.json found: Project = current directory name, App = current package name
+
+3. **Single Package**:
+   - Project: Package name
+   - App: Package name
+
 ## Internal APIs
 
 ### Build Context API

package/dist/index.d.ts

@@ -8,7 +8,9 @@ export { applyBaseHrefToAssets, normalizeBasePath, } from './lib/transformers/ze
 export { zeBuildAssets } from './lib/transformers/ze-build-assets';
 export { buildAssetsMap, type ZeBuildAssetsMap, } from './lib/transformers/ze-build-assets-map';
 export { zeBuildDashData } from './lib/transformers/ze-build-dash-data';
+export { create_minimal_build_stats } from './lib/transformers/ze-minimal-build-stats';
 export { DEFAULT_AUTH_COMPLETION_TIMEOUT_MS, TOKEN_EXPIRY } from './lib/auth/auth-flags';
+export { getCatalogPackages, resolveCatalogDependencies, resolveCatalogVersion, } from './lib/build-context/resolve-catalog-version';
 export { is_zephyr_dependency_pair, readPackageJson, ZephyrEngine, type ZeDependencyPair, type ZephyrDependencies, type ZephyrEngineOptions, } from './zephyr-engine';
 export type { Platform } from './zephyr-engine';
 export type { ZeResolvedDependency } from './zephyr-engine/resolve_remote_dependency';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZephyrEngine = exports.readPackageJson = exports.is_zephyr_dependency_pair = exports.TOKEN_EXPIRY = exports.DEFAULT_AUTH_COMPLETION_TIMEOUT_MS = exports.zeBuildDashData = exports.buildAssetsMap = exports.zeBuildAssets = exports.normalizeBasePath = exports.applyBaseHrefToAssets = exports.logFn = exports.ze_log = exports.getAppDeployResult = exports.getAllDeployedApps = exports.getAllAppDeployResults = exports.ZephyrError = exports.ZeErrors = exports.savePartialAssetMap = exports.removePartialAssetMap = exports.getPartialAssetMap = exports.resolveIndexHtml = exports.onIndexHtmlResolved = void 0;
+exports.ZephyrEngine = exports.readPackageJson = exports.is_zephyr_dependency_pair = exports.resolveCatalogVersion = exports.resolveCatalogDependencies = exports.getCatalogPackages = exports.TOKEN_EXPIRY = exports.DEFAULT_AUTH_COMPLETION_TIMEOUT_MS = exports.create_minimal_build_stats = exports.zeBuildDashData = exports.buildAssetsMap = exports.zeBuildAssets = exports.normalizeBasePath = exports.applyBaseHrefToAssets = exports.logFn = exports.ze_log = exports.getAppDeployResult = exports.getAllDeployedApps = exports.getAllAppDeployResults = exports.ZephyrError = exports.ZeErrors = exports.savePartialAssetMap = exports.removePartialAssetMap = exports.getPartialAssetMap = exports.resolveIndexHtml = exports.onIndexHtmlResolved = void 0;
 // hack for angular
 var resolve_index_html_1 = require("./lib/hacks/resolve-index-html");
 Object.defineProperty(exports, "onIndexHtmlResolved", { enumerable: true, get: function () { return resolve_index_html_1.onIndexHtmlResolved; } });
@@ -34,10 +34,17 @@ var ze_build_assets_map_1 = require("./lib/transformers/ze-build-assets-map");
 Object.defineProperty(exports, "buildAssetsMap", { enumerable: true, get: function () { return ze_build_assets_map_1.buildAssetsMap; } });
 var ze_build_dash_data_1 = require("./lib/transformers/ze-build-dash-data");
 Object.defineProperty(exports, "zeBuildDashData", { enumerable: true, get: function () { return ze_build_dash_data_1.zeBuildDashData; } });
+var ze_minimal_build_stats_1 = require("./lib/transformers/ze-minimal-build-stats");
+Object.defineProperty(exports, "create_minimal_build_stats", { enumerable: true, get: function () { return ze_minimal_build_stats_1.create_minimal_build_stats; } });
 // Auth related exports
 var auth_flags_1 = require("./lib/auth/auth-flags");
 Object.defineProperty(exports, "DEFAULT_AUTH_COMPLETION_TIMEOUT_MS", { enumerable: true, get: function () { return auth_flags_1.DEFAULT_AUTH_COMPLETION_TIMEOUT_MS; } });
 Object.defineProperty(exports, "TOKEN_EXPIRY", { enumerable: true, get: function () { return auth_flags_1.TOKEN_EXPIRY; } });
+// Catalog related exports
+var resolve_catalog_version_1 = require("./lib/build-context/resolve-catalog-version");
+Object.defineProperty(exports, "getCatalogPackages", { enumerable: true, get: function () { return resolve_catalog_version_1.getCatalogPackages; } });
+Object.defineProperty(exports, "resolveCatalogDependencies", { enumerable: true, get: function () { return resolve_catalog_version_1.resolveCatalogDependencies; } });
+Object.defineProperty(exports, "resolveCatalogVersion", { enumerable: true, get: function () { return resolve_catalog_version_1.resolveCatalogVersion; } });
 // Zephyr Edge is the main class which should be used
 var zephyr_engine_1 = require("./zephyr-engine");
 Object.defineProperty(exports, "is_zephyr_dependency_pair", { enumerable: true, get: function () { return zephyr_engine_1.is_zephyr_dependency_pair; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,qEAAuF;AAA9E,yHAAA,mBAAmB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAC9C,sBAAsB;AACtB,4EAI+C;AAH7C,wHAAA,kBAAkB,OAAA;AAClB,2HAAA,qBAAqB,OAAA;AACrB,yHAAA,mBAAmB,OAAA;AAGrB,SAAS;AACT,uCAAqD;AAA5C,kGAAA,QAAQ,OAAA;AAAE,qGAAA,WAAW,OAAA;AAE9B,gBAAgB;AAChB,sFAKoD;AAJlD,iIAAA,sBAAsB,OAAA;AACtB,6HAAA,kBAAkB,OAAA;AAClB,6HAAA,kBAAkB,OAAA;AAIpB,SAAS;AACT,yCAAuC;AAA9B,iGAAA,MAAM,OAAA;AACf,2DAAmD;AAA1C,qGAAA,KAAK,OAAA;AAEd,uBAAuB;AACvB,8EAGgD;AAF9C,4HAAA,qBAAqB,OAAA;AACrB,wHAAA,iBAAiB,OAAA;AAEnB,sEAAmE;AAA1D,gHAAA,aAAa,OAAA;AACtB,8EAGgD;AAF9C,qHAAA,cAAc,OAAA;AAGhB,4EAAwE;AAA/D,qHAAA,eAAe,OAAA;AAExB,uBAAuB;AACvB,oDAAyF;AAAhF,gIAAA,kCAAkC,OAAA;AAAE,0GAAA,YAAY,OAAA;AAEzD,qDAAqD;AACrD,iDAOyB;AANvB,0HAAA,yBAAyB,OAAA;AACzB,gHAAA,eAAe,OAAA;AACf,6GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,qEAAuF;AAA9E,yHAAA,mBAAmB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAC9C,sBAAsB;AACtB,4EAI+C;AAH7C,wHAAA,kBAAkB,OAAA;AAClB,2HAAA,qBAAqB,OAAA;AACrB,yHAAA,mBAAmB,OAAA;AAGrB,SAAS;AACT,uCAAqD;AAA5C,kGAAA,QAAQ,OAAA;AAAE,qGAAA,WAAW,OAAA;AAE9B,gBAAgB;AAChB,sFAKoD;AAJlD,iIAAA,sBAAsB,OAAA;AACtB,6HAAA,kBAAkB,OAAA;AAClB,6HAAA,kBAAkB,OAAA;AAIpB,SAAS;AACT,yCAAuC;AAA9B,iGAAA,MAAM,OAAA;AACf,2DAAmD;AAA1C,qGAAA,KAAK,OAAA;AAEd,uBAAuB;AACvB,8EAGgD;AAF9C,4HAAA,qBAAqB,OAAA;AACrB,wHAAA,iBAAiB,OAAA;AAEnB,sEAAmE;AAA1D,gHAAA,aAAa,OAAA;AACtB,8EAGgD;AAF9C,qHAAA,cAAc,OAAA;AAGhB,4EAAwE;AAA/D,qHAAA,eAAe,OAAA;AACxB,oFAAuF;AAA9E,oIAAA,0BAA0B,OAAA;AAEnC,uBAAuB;AACvB,oDAAyF;AAAhF,gIAAA,kCAAkC,OAAA;AAAE,0GAAA,YAAY,OAAA;AAEzD,0BAA0B;AAC1B,uFAIqD;AAHnD,6HAAA,kBAAkB,OAAA;AAClB,qIAAA,0BAA0B,OAAA;AAC1B,gIAAA,qBAAqB,OAAA;AAGvB,qDAAqD;AACrD,iDAOyB;AANvB,0HAAA,yBAAyB,OAAA;AACzB,gHAAA,eAAe,OAAA;AACf,6GAAA,YAAY,OAAA"}

package/dist/lib/build-context/detect-monorepo.d.ts

@@ -0,0 +1,14 @@
+export type MonorepoType = 'pnpm' | 'yarn' | 'npm' | 'lerna' | 'nx' | 'rush' | 'none';
+export interface MonorepoInfo {
+    type: MonorepoType;
+    root: string;
+    configFile?: string;
+    workspaces?: string[];
+}
+/**
+ * Detects if the current project is part of a monorepo and returns information about it.
+ * Traverses up the directory tree looking for monorepo configuration files.
+ */
+export declare function detectMonorepo(startPath: string): Promise<MonorepoInfo>;
+/** Gets the root package.json from a monorepo root directory */
+export declare function getMonorepoRootPackageJson(monorepoRoot: string): Promise<Record<string, unknown> | null>;

package/dist/lib/build-context/detect-monorepo.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectMonorepo = detectMonorepo;
+exports.getMonorepoRootPackageJson = getMonorepoRootPackageJson;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const debug_1 = require("../logging/debug");
+const MONOREPO_CONFIG_FILES = [
+    { file: 'pnpm-workspace.yaml', type: 'pnpm' },
+    { file: 'pnpm-workspace.yml', type: 'pnpm' },
+    { file: 'lerna.json', type: 'lerna' },
+    { file: 'nx.json', type: 'nx' },
+    { file: 'rush.json', type: 'rush' },
+];
+const MAX_TRAVERSAL_DEPTH = 10;
+/**
+ * Detects if the current project is part of a monorepo and returns information about it.
+ * Traverses up the directory tree looking for monorepo configuration files.
+ */
+async function detectMonorepo(startPath) {
+    var _a, _b;
+    let currentDir = (0, node_path_1.resolve)(startPath);
+    let depth = 0;
+    while (depth < MAX_TRAVERSAL_DEPTH) {
+        // Check for specific monorepo config files
+        for (const config of MONOREPO_CONFIG_FILES) {
+            const configPath = (0, node_path_1.join)(currentDir, config.file);
+            if (fileExists(configPath)) {
+                debug_1.ze_log.misc(`Found ${config.type} monorepo config at ${configPath}`);
+                return {
+                    type: config.type,
+                    root: currentDir,
+                    configFile: configPath,
+                };
+            }
+        }
+        // Check for package.json with workspaces
+        const packageJsonPath = (0, node_path_1.join)(currentDir, 'package.json');
+        if (fileExists(packageJsonPath)) {
+            try {
+                const content = await (0, promises_1.readFile)(packageJsonPath, 'utf8');
+                const packageJson = JSON.parse(content);
+                // Check for npm/yarn workspaces
+                if (packageJson.workspaces) {
+                    debug_1.ze_log.misc(`Found ${((_a = packageJson.packageManager) === null || _a === void 0 ? void 0 : _a.startsWith('yarn')) ? 'yarn' : 'npm'} workspaces at ${packageJsonPath}`);
+                    return {
+                        type: ((_b = packageJson.packageManager) === null || _b === void 0 ? void 0 : _b.startsWith('yarn')) ? 'yarn' : 'npm',
+                        root: currentDir,
+                        configFile: packageJsonPath,
+                        workspaces: Array.isArray(packageJson.workspaces)
+                            ? packageJson.workspaces
+                            : packageJson.workspaces.packages || [],
+                    };
+                }
+                // Check for .yarnrc.yml in the same directory (Yarn Berry)
+                const yarnrcPath = (0, node_path_1.join)(currentDir, '.yarnrc.yml');
+                if (fileExists(yarnrcPath)) {
+                    debug_1.ze_log.misc(`Found Yarn Berry workspace at ${currentDir}`);
+                    return {
+                        type: 'yarn',
+                        root: currentDir,
+                        configFile: yarnrcPath,
+                    };
+                }
+            }
+            catch (error) {
+                debug_1.ze_log.misc(`Error reading package.json at ${packageJsonPath}:`, error);
+            }
+        }
+        // Check if we've reached the root
+        const parentDir = (0, node_path_1.resolve)(currentDir, '..');
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    debug_1.ze_log.misc('No monorepo configuration found');
+    return {
+        type: 'none',
+        root: startPath,
+    };
+}
+/** Gets the root package.json from a monorepo root directory */
+async function getMonorepoRootPackageJson(monorepoRoot) {
+    const packageJsonPath = (0, node_path_1.join)(monorepoRoot, 'package.json');
+    if (!fileExists(packageJsonPath)) {
+        return null;
+    }
+    try {
+        const content = await (0, promises_1.readFile)(packageJsonPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        debug_1.ze_log.misc(`Error reading root package.json at ${packageJsonPath}:`, error);
+        return null;
+    }
+}
+function fileExists(path) {
+    try {
+        (0, node_fs_1.accessSync)(path, node_fs_1.constants.F_OK);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+//# sourceMappingURL=detect-monorepo.js.map

package/dist/lib/build-context/detect-monorepo.js.map

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

package/dist/lib/build-context/resolve-catalog-version.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves a catalog dependency version string (e.g., "catalog:react18") to its actual
+ * semver version range from pnpm-workspace.yaml
+ *
+ * @param versionString The version string to resolve
+ * @param packageName Optional package name to look up specific package in catalog
+ * @returns The resolved semver version or the original version if not a catalog reference
+ */
+export declare function resolveCatalogVersion(versionString: string, packageName?: string): string;
+/**
+ * Gets all packages with their versions for a specific catalog
+ *
+ * @param catalogName The name of the catalog
+ * @returns Object mapping package names to their versions, or null if catalog not found
+ */
+export declare function getCatalogPackages(catalogName: string): Record<string, string> | null;
+/**
+ * Resolves a dependency versions object, looking for catalog: references and replacing
+ * them with the actual semver version ranges
+ *
+ * @param dependencies Package dependencies object (e.g., from package.json)
+ * @returns New dependencies object with resolved versions
+ */
+export declare function resolveCatalogDependencies(dependencies: Record<string, string> | undefined): Record<string, string>;

package/dist/lib/build-context/resolve-catalog-version.js

@@ -0,0 +1,365 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCatalogVersion = resolveCatalogVersion;
+exports.getCatalogPackages = getCatalogPackages;
+exports.resolveCatalogDependencies = resolveCatalogDependencies;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const zephyr_edge_contract_1 = require("zephyr-edge-contract");
+const logging_1 = require("../logging");
+/** Cache for workspace config to avoid repeated file reads */
+let workspaceConfigCache = null;
+/** Cache for workspace packages to avoid repeated file scanning */
+let workspacePackagesCache = null;
+/**
+ * Reads the pnpm-workspace.yaml file to get catalog definitions
+ *
+ * @param workspacePath Optional path to the workspace file
+ * @returns The parsed pnpm workspace configuration
+ */
+function readWorkspaceConfig(workspacePath) {
+    if (workspaceConfigCache) {
+        return workspaceConfigCache;
+    }
+    // Try to find pnpm-workspace.yaml in current directory or parent directories
+    const searchPath = workspacePath || findWorkspaceFile();
+    if (!searchPath) {
+        logging_1.ze_log.app('Warning: Could not find pnpm-workspace.yaml file');
+        return {};
+    }
+    try {
+        // Using require would be simpler, but we'll use fs to read and YAML parse
+        // for more explicit error handling and to avoid needing yaml package
+        const yaml = fs.readFileSync(searchPath, 'utf8');
+        const config = parseYaml(yaml);
+        workspaceConfigCache = config;
+        return config;
+    }
+    catch (error) {
+        logging_1.ze_log.app('Error reading pnpm-workspace.yaml:', error);
+        return {};
+    }
+}
+/**
+ * Simple YAML parser for pnpm-workspace.yaml This is a basic implementation that handles
+ * the format we expect in pnpm-workspace.yaml
+ */
+function parseYaml(yaml) {
+    const result = {};
+    let currentSection = null;
+    let currentSubsection = null;
+    const lines = yaml.split('\n');
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Skip comments and empty lines
+        if (trimmedLine.startsWith('#') || !trimmedLine) {
+            continue;
+        }
+        // Check for main sections
+        if (trimmedLine.endsWith(':')) {
+            currentSection = trimmedLine.slice(0, -1);
+            if (!currentSection) {
+                currentSubsection = null;
+            }
+            if (currentSection === 'catalogs') {
+                result.catalogs = {};
+            }
+            if (currentSection === 'packages') {
+                result.packages = [];
+            }
+            // Get the catalog's name
+            if (trimmedLine.endsWith(':') && currentSection !== 'catalogs' && result.catalogs) {
+                currentSubsection = trimmedLine.trim().slice(0, -1);
+                result.catalogs[currentSubsection] = {};
+            }
+        }
+        // Parse packages section
+        if (currentSection === 'packages' && trimmedLine.startsWith('-')) {
+            const pattern = trimmedLine.slice(1).trim();
+            // Remove quotes if present
+            const cleanPattern = pattern.replace(/^['"]|['"]$/g, '');
+            if (!result.packages) {
+                result.packages = [];
+            }
+            result.packages.push(cleanPattern);
+        }
+        // Get the key and value from the line (at here should be npm dependency name)
+        if (trimmedLine.includes(':') && currentSection !== 'catalogs' && result.catalogs) {
+            if (currentSubsection) {
+                const [key, value] = trimmedLine.split(':', 2).map((part) => part.trim());
+                // remove all the double quotes and single quotes and replace them with '\'', because this is affecting the replacement
+                const cleanedKey = key.replace(/['"]/g, '');
+                result.catalogs[currentSubsection][cleanedKey] = value;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Finds the pnpm-workspace.yaml file by looking in the current directory and traversing
+ * up the directory tree
+ */
+function findWorkspaceFile() {
+    let currentDir = process.cwd();
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const workspacePath = path.join(currentDir, 'pnpm-workspace.yaml');
+        if (fs.existsSync(workspacePath)) {
+            return workspacePath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Gets the workspace root directory by finding the directory containing the
+ * pnpm-workspace.yaml file
+ */
+function getWorkspaceRoot() {
+    const workspaceFile = findWorkspaceFile();
+    if (!workspaceFile) {
+        return null;
+    }
+    return path.dirname(workspaceFile);
+}
+/**
+ * Find package.json files in a directory according to glob-like patterns This is a custom
+ * implementation to replace glob.sync
+ *
+ * @param rootDir The root directory to start searching from
+ * @param includePattern The pattern to include (e.g., "libs/**")
+ * @param excludePatterns Array of patterns to exclude
+ * @returns Array of absolute paths to matching package.json files
+ */
+function findPackageJsonFiles(rootDir, includePattern, excludePatterns = []) {
+    const results = [];
+    // Convert glob-like pattern to regex pattern for matching
+    const patternParts = includePattern.split('/');
+    const baseDir = patternParts[0] === '**' ? '' : patternParts[0];
+    const hasDoubleGlob = includePattern.includes('**');
+    // Build the full base path
+    const basePath = path.join(rootDir, baseDir);
+    // Check if the base directory exists
+    if (!fs.existsSync(basePath) || !fs.statSync(basePath).isDirectory()) {
+        return [];
+    }
+    // Function to check if a path should be excluded
+    const isExcluded = (filePath) => {
+        const relativePath = path.relative(rootDir, filePath);
+        return excludePatterns.some((pattern) => {
+            // Remove the ! from negated patterns
+            const cleanPattern = pattern.startsWith('!') ? pattern.slice(1) : pattern;
+            // Simple string matching for exact paths or basic wildcards
+            if (cleanPattern.endsWith('/**')) {
+                const prefix = cleanPattern.slice(0, -3);
+                return relativePath.startsWith(prefix);
+            }
+            return (relativePath === cleanPattern ||
+                (cleanPattern.includes('*') &&
+                    relativePath.startsWith(cleanPattern.split('*')[0])));
+        });
+    };
+    // Recursive function to find package.json files
+    const findRecursively = (dir, depth = 0) => {
+        if (isExcluded(dir)) {
+            return;
+        }
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (isExcluded(fullPath)) {
+                    continue;
+                }
+                if (entry.isDirectory() && (hasDoubleGlob || depth < patternParts.length)) {
+                    // Recurse into directories if we have ** or haven't reached max depth
+                    findRecursively(fullPath, depth + 1);
+                }
+                else if (entry.name === 'package.json') {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            logging_1.ze_log.app(`Error reading directory ${dir}:`, error);
+        }
+    };
+    // Start the recursive search
+    findRecursively(basePath);
+    return results;
+}
+/**
+ * Finds all package.json files in the workspace based on the patterns specified in the
+ * pnpm-workspace.yaml file
+ */
+function findWorkspacePackages() {
+    // Return cached result if available
+    if (workspacePackagesCache) {
+        return workspacePackagesCache;
+    }
+    const workspaceRoot = getWorkspaceRoot();
+    if (!workspaceRoot) {
+        logging_1.ze_log.app('Warning: Could not find workspace root directory');
+        return new Map();
+    }
+    const config = readWorkspaceConfig();
+    if (!config.packages || config.packages.length === 0) {
+        logging_1.ze_log.app('Warning: No workspace packages defined in pnpm-workspace.yaml');
+        return new Map();
+    }
+    const packageJsonMap = new Map();
+    const includePatterns = [];
+    const excludePatterns = [];
+    // Separate include and exclude patterns
+    for (const pattern of config.packages) {
+        if (pattern.startsWith('!')) {
+            excludePatterns.push(pattern.slice(1));
+        }
+        else {
+            includePatterns.push(pattern);
+        }
+    }
+    // Process include patterns
+    for (const includePattern of includePatterns) {
+        try {
+            // Use our own file finder instead of glob
+            const packageJsonPaths = findPackageJsonFiles(workspaceRoot, includePattern, excludePatterns);
+            // Read each package.json file
+            for (const packageJsonPath of packageJsonPaths) {
+                try {
+                    const packageJsonContent = fs.readFileSync(packageJsonPath, 'utf8');
+                    const packageJson = (0, zephyr_edge_contract_1.safe_json_parse)(packageJsonContent);
+                    if (packageJson && packageJson.name) {
+                        packageJsonMap.set(packageJson.name, packageJson);
+                    }
+                }
+                catch (error) {
+                    logging_1.ze_log.app(`Error reading package.json at ${packageJsonPath}:`, error);
+                }
+            }
+        }
+        catch (error) {
+            logging_1.ze_log.app(`Error processing pattern ${includePattern}:`, error);
+        }
+    }
+    // Cache the result
+    workspacePackagesCache = packageJsonMap;
+    return packageJsonMap;
+}
+/**
+ * Resolves a workspace:* dependency by finding the package in the workspace
+ *
+ * @param packageName The name of the package to find in the workspace
+ * @returns The version of the package, or null if not found
+ */
+function resolveWorkspaceVersion(packageName) {
+    var _a;
+    const workspacePackages = findWorkspacePackages();
+    if (workspacePackages.has(packageName)) {
+        return ((_a = workspacePackages.get(packageName)) === null || _a === void 0 ? void 0 : _a.version) || null;
+    }
+    return null;
+}
+/**
+ * Resolves a catalog dependency version string (e.g., "catalog:react18") to its actual
+ * semver version range from pnpm-workspace.yaml
+ *
+ * @param versionString The version string to resolve
+ * @param packageName Optional package name to look up specific package in catalog
+ * @returns The resolved semver version or the original version if not a catalog reference
+ */
+function resolveCatalogVersion(versionString, packageName) {
+    // If it's not a catalog reference, return as is
+    if (!versionString ||
+        typeof versionString !== 'string' ||
+        !versionString.startsWith('catalog:')) {
+        return versionString;
+    }
+    // Extract catalog name from format "catalog:catalogName"
+    const catalogName = versionString.substring(8); // Remove "catalog:" prefix
+    // Read workspace config to get catalog information
+    const config = readWorkspaceConfig();
+    // If no catalogs section or the specified catalog doesn't exist
+    if (!config.catalogs || !Object.keys(config.catalogs).includes(catalogName)) {
+        logging_1.ze_log.app(`Warning: Catalog "${catalogName}" not found in pnpm-workspace.yaml`);
+        return versionString; // Return the original version string as fallback
+    }
+    // If a package name is provided, look for that specific package in the catalog
+    if (packageName && config.catalogs[catalogName][packageName]) {
+        return config.catalogs[catalogName][packageName];
+    }
+    // Return an object representation of all versions in this catalog
+    // This is useful for module federation shared config
+    return JSON.stringify(config.catalogs[catalogName]);
+}
+/**
+ * Gets all packages with their versions for a specific catalog
+ *
+ * @param catalogName The name of the catalog
+ * @returns Object mapping package names to their versions, or null if catalog not found
+ */
+function getCatalogPackages(catalogName) {
+    // Read workspace config to get catalog information
+    const config = readWorkspaceConfig();
+    // If no catalogs section or the specified catalog doesn't exist
+    if (!config.catalogs || !Object.keys(config.catalogs).includes(catalogName)) {
+        logging_1.ze_log.app(`Warning: Catalog "${catalogName}" not found in pnpm-workspace.yaml`);
+        return null;
+    }
+    return config.catalogs[catalogName];
+}
+/**
+ * Resolves a dependency versions object, looking for catalog: references and replacing
+ * them with the actual semver version ranges
+ *
+ * @param dependencies Package dependencies object (e.g., from package.json)
+ * @returns New dependencies object with resolved versions
+ */
+function resolveCatalogDependencies(dependencies) {
+    if (!dependencies)
+        return {};
+    const result = {};
+    for (const [name, version] of Object.entries(dependencies)) {
+        if (version && typeof version === 'string' && version.startsWith('catalog:')) {
+            const catalogName = version.substring(8);
+            const catalogPackages = getCatalogPackages(catalogName);
+            if (catalogPackages && catalogPackages[name]) {
+                // Use the specific package version from the catalog
+                result[name] = catalogPackages[name];
+            }
+            else {
+                // If the exact package isn't in the catalog, keep the original for backward compatibility
+                result[name] = version;
+                logging_1.ze_log.app(`Warning: Package ${name} not found in catalog ${catalogName}, using original reference`);
+            }
+        }
+        else if (version === 'workspace:*') {
+            // Handle workspace references by finding the package in the workspace
+            const resolvedVersion = resolveWorkspaceVersion(name);
+            if (resolvedVersion) {
+                result[name] = resolvedVersion;
+            }
+            else {
+                // If the package isn't found in the workspace, keep the original
+                result[name] = version;
+                logging_1.ze_log.app(`Warning: Package ${name} not found in workspace, using original reference`);
+            }
+        }
+        else if (version && typeof version === 'string') {
+            // Handle normal semver
+            result[name] = version;
+        }
+        else if (version) {
+            // Handle other non-standard formats by stringifying
+            result[name] = String(version);
+        }
+        else {
+            // Fallback for edge cases
+            result[name] = '*';
+            logging_1.ze_log.app(`Warning: No valid version found for ${name}, it's using wildcard '*'`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=resolve-catalog-version.js.map