zephyr-agent 0.0.54 → 0.0.56

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

@@ -1,13 +1,14 @@
 export { onIndexHtmlResolved, resolveIndexHtml } from './lib/hacks/resolve-index-html';
 export { getPartialAssetMap, removePartialAssetMap, savePartialAssetMap, } from './lib/node-persist/partial-assets-map';
-export { ZephyrError, ZeErrors } from './lib/errors';
+export { ZeErrors, ZephyrError } from './lib/errors';
+export { getAllAppDeployResults, getAllDeployedApps, getAppDeployResult, type DeployResult, } from './lib/node-persist/app-deploy-result-cache';
 export { ze_log } from './lib/logging';
 export { logFn } from './lib/logging/ze-log-event';
+export { applyBaseHrefToAssets, normalizeBasePath, } from './lib/transformers/ze-basehref-handler';
+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 { zeBuildAssets } from './lib/transformers/ze-build-assets';
-export { normalizeBasePath, applyBaseHrefToAssets, } from './lib/transformers/ze-basehref-handler';
 export { DEFAULT_AUTH_COMPLETION_TIMEOUT_MS, TOKEN_EXPIRY } from './lib/auth/auth-flags';
-export { ZephyrEngine, is_zephyr_dependency_pair, type ZeDependencyPair, type ZephyrDependencies, type ZephyrEngineOptions, readPackageJson, } from './zephyr-engine';
-export type { ZeResolvedDependency } from './zephyr-engine/resolve_remote_dependency';
+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.readPackageJson = exports.is_zephyr_dependency_pair = exports.ZephyrEngine = exports.TOKEN_EXPIRY = exports.DEFAULT_AUTH_COMPLETION_TIMEOUT_MS = exports.applyBaseHrefToAssets = exports.normalizeBasePath = exports.zeBuildAssets = exports.zeBuildDashData = exports.buildAssetsMap = exports.logFn = exports.ze_log = exports.ZeErrors = exports.ZephyrError = exports.savePartialAssetMap = exports.removePartialAssetMap = exports.getPartialAssetMap = exports.resolveIndexHtml = exports.onIndexHtmlResolved = void 0;
+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;
 // 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; } });
@@ -12,30 +12,35 @@ Object.defineProperty(exports, "removePartialAssetMap", { enumerable: true, get:
 Object.defineProperty(exports, "savePartialAssetMap", { enumerable: true, get: function () { return partial_assets_map_1.savePartialAssetMap; } });
 // errors
 var errors_1 = require("./lib/errors");
-Object.defineProperty(exports, "ZephyrError", { enumerable: true, get: function () { return errors_1.ZephyrError; } });
 Object.defineProperty(exports, "ZeErrors", { enumerable: true, get: function () { return errors_1.ZeErrors; } });
+Object.defineProperty(exports, "ZephyrError", { enumerable: true, get: function () { return errors_1.ZephyrError; } });
+// deploy result
+var app_deploy_result_cache_1 = require("./lib/node-persist/app-deploy-result-cache");
+Object.defineProperty(exports, "getAllAppDeployResults", { enumerable: true, get: function () { return app_deploy_result_cache_1.getAllAppDeployResults; } });
+Object.defineProperty(exports, "getAllDeployedApps", { enumerable: true, get: function () { return app_deploy_result_cache_1.getAllDeployedApps; } });
+Object.defineProperty(exports, "getAppDeployResult", { enumerable: true, get: function () { return app_deploy_result_cache_1.getAppDeployResult; } });
 // logger
 var logging_1 = require("./lib/logging");
 Object.defineProperty(exports, "ze_log", { enumerable: true, get: function () { return logging_1.ze_log; } });
 var ze_log_event_1 = require("./lib/logging/ze-log-event");
 Object.defineProperty(exports, "logFn", { enumerable: true, get: function () { return ze_log_event_1.logFn; } });
 // default transformers
+var ze_basehref_handler_1 = require("./lib/transformers/ze-basehref-handler");
+Object.defineProperty(exports, "applyBaseHrefToAssets", { enumerable: true, get: function () { return ze_basehref_handler_1.applyBaseHrefToAssets; } });
+Object.defineProperty(exports, "normalizeBasePath", { enumerable: true, get: function () { return ze_basehref_handler_1.normalizeBasePath; } });
+var ze_build_assets_1 = require("./lib/transformers/ze-build-assets");
+Object.defineProperty(exports, "zeBuildAssets", { enumerable: true, get: function () { return ze_build_assets_1.zeBuildAssets; } });
 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_build_assets_1 = require("./lib/transformers/ze-build-assets");
-Object.defineProperty(exports, "zeBuildAssets", { enumerable: true, get: function () { return ze_build_assets_1.zeBuildAssets; } });
-var ze_basehref_handler_1 = require("./lib/transformers/ze-basehref-handler");
-Object.defineProperty(exports, "normalizeBasePath", { enumerable: true, get: function () { return ze_basehref_handler_1.normalizeBasePath; } });
-Object.defineProperty(exports, "applyBaseHrefToAssets", { enumerable: true, get: function () { return ze_basehref_handler_1.applyBaseHrefToAssets; } });
 // 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; } });
 // Zephyr Edge is the main class which should be used
 var zephyr_engine_1 = require("./zephyr-engine");
-Object.defineProperty(exports, "ZephyrEngine", { enumerable: true, get: function () { return zephyr_engine_1.ZephyrEngine; } });
 Object.defineProperty(exports, "is_zephyr_dependency_pair", { enumerable: true, get: function () { return zephyr_engine_1.is_zephyr_dependency_pair; } });
 Object.defineProperty(exports, "readPackageJson", { enumerable: true, get: function () { return zephyr_engine_1.readPackageJson; } });
+Object.defineProperty(exports, "ZephyrEngine", { enumerable: true, get: function () { return zephyr_engine_1.ZephyrEngine; } });
 //# sourceMappingURL=index.js.map

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,qGAAA,WAAW,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAE9B,SAAS;AACT,yCAAuC;AAA9B,iGAAA,MAAM,OAAA;AACf,2DAAmD;AAA1C,qGAAA,KAAK,OAAA;AAEd,uBAAuB;AACvB,8EAGgD;AAF9C,qHAAA,cAAc,OAAA;AAGhB,4EAAwE;AAA/D,qHAAA,eAAe,OAAA;AACxB,sEAAmE;AAA1D,gHAAA,aAAa,OAAA;AACtB,8EAGgD;AAF9C,wHAAA,iBAAiB,OAAA;AACjB,4HAAA,qBAAqB,OAAA;AAGvB,uBAAuB;AACvB,oDAAyF;AAAhF,gIAAA,kCAAkC,OAAA;AAAE,0GAAA,YAAY,OAAA;AAEzD,qDAAqD;AACrD,iDAOyB;AANvB,6GAAA,YAAY,OAAA;AACZ,0HAAA,yBAAyB,OAAA;AAIzB,gHAAA,eAAe,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;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"}

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/ze-util-get-git-info.js

@@ -4,35 +4,87 @@ exports.getGitInfo = getGitInfo;
 const tslib_1 = require("tslib");
 const is_ci_1 = tslib_1.__importDefault(require("is-ci"));
 const node_child_process_1 = require("node:child_process");
-const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
 const node_util_1 = require("node:util");
+const zephyr_edge_contract_1 = require("zephyr-edge-contract");
+const login_1 = require("../auth/login");
 const errors_1 = require("../errors");
+const http_request_1 = require("../http/http-request");
 const logging_1 = require("../logging");
+const ze_log_event_1 = require("../logging/ze-log-event");
 const secret_token_1 = require("../node-persist/secret-token");
+const token_1 = require("../node-persist/token");
 const git_provider_utils_1 = require("./git-provider-utils");
+const detect_monorepo_1 = require("./detect-monorepo");
+const ze_util_read_package_json_1 = require("./ze-util-read-package-json");
 const exec = (0, node_util_1.promisify)(node_child_process_1.exec);
+/** Generate branch name for non-git contexts */
+function generateBranchName(context, userId) {
+    const timestamp = new Date().toISOString().replace(/\D/g, '');
+    const userSuffix = userId ? `-${userId.slice(0, 8)}` : '';
+    return `${context}${userSuffix}-${timestamp}`;
+}
 /** Loads the git information from the current repository. */
 async function getGitInfo() {
+    // Always gather fresh git info for build accuracy
+    return await gatherGitInfo();
+}
+/** Internal function that actually gathers git information. */
+async function gatherGitInfo() {
     const hasToken = (0, secret_token_1.hasSecretToken)();
-    const { name, email, remoteOrigin, branch, commit, tags, stdout } = await loadGitInfo(hasToken);
-    if (!hasToken && (!name || !email)) {
-        throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_USERNAME_EMAIL, {
-            data: { stdout },
-        });
+    try {
+        const { name, email, remoteOrigin, branch, commit, tags, stdout } = await loadGitInfo(hasToken);
+        if (!hasToken && (!name || !email)) {
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_USERNAME_EMAIL, {
+                data: { stdout },
+            });
+        }
+        const app = parseGitUrl(remoteOrigin, stdout);
+        const gitInfo = {
+            git: { name, email, branch, commit, tags },
+            app,
+        };
+        logging_1.ze_log.git('Loaded: git info', gitInfo);
+        return gitInfo;
+    }
+    catch (error) {
+        // In CI environments, fail immediately if git info is not available
+        if (is_ci_1.default) {
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Git repository information is required in CI environments',
+                cause: error,
+            });
+        }
+        // If git repo info is not available, try global git config
+        (0, ze_log_event_1.logFn)('warn', 'Git repository not found. Zephyr REQUIRES a git repository with remote origin.');
+        (0, ze_log_event_1.logFn)('warn', 'Manual configuration is NOT recommended and WILL cause errors in production.');
+        (0, ze_log_event_1.logFn)('warn', '');
+        (0, ze_log_event_1.logFn)('warn', 'To properly use Zephyr, you MUST:');
+        (0, ze_log_event_1.logFn)('warn', '1. Initialize git: git init');
+        (0, ze_log_event_1.logFn)('warn', '2. Add remote: git remote add origin git@github.com:ORG/REPO.git');
+        (0, ze_log_event_1.logFn)('warn', '3. Commit your changes: git add . && git commit -m "Initial commit"');
+        (0, ze_log_event_1.logFn)('warn', '');
+        (0, ze_log_event_1.logFn)('warn', 'Alternative: Use our CLI for automatic setup: npx create-zephyr-apps');
+        (0, ze_log_event_1.logFn)('warn', '📝 Documentation: https://docs.zephyr-cloud.io');
+        logging_1.ze_log.git('Git repository not found, falling back to global git config');
+        try {
+            const globalGitInfo = await loadGlobalGitInfo();
+            return globalGitInfo;
+        }
+        catch (_a) {
+            // If global git config also fails, use defaults
+            (0, ze_log_event_1.logFn)('warn', 'Global git config not found, using auto-generated defaults');
+            logging_1.ze_log.git('Global git config not found, using auto-generated defaults');
+            const fallbackInfo = await getFallbackGitInfo();
+            return fallbackInfo;
+        }
     }
-    const app = parseGitUrl(remoteOrigin, stdout);
-    const gitInfo = {
-        git: { name, email, branch, commit, tags },
-        app,
-    };
-    logging_1.ze_log.git('Loaded: git info', gitInfo);
-    return gitInfo;
 }
+// Static delimiter that's unique enough to avoid conflicts with git output
+const GIT_OUTPUT_DELIMITER = '---ZEPHYR-GIT-DELIMITER-8f3a2b1c---';
 /** Loads all data in a single command to avoid multiple executions. */
 async function loadGitInfo(hasSecretToken) {
     const automated = is_ci_1.default || hasSecretToken;
-    // ensures multi line output on errors doesn't break the parsing
-    const delimiter = (0, node_crypto_1.randomUUID)().repeat(2);
     const command = [
         // Inside CI environments, the last committer should be the actor
         // and not the actual logged git user which sometimes might just be a bot
@@ -43,12 +95,12 @@ async function loadGitInfo(hasSecretToken) {
         'git rev-parse --abbrev-ref HEAD',
         'git rev-parse HEAD',
         'git tag --points-at HEAD',
-    ].join(` && echo ${delimiter} && `);
+    ].join(` && echo ${GIT_OUTPUT_DELIMITER} && `);
     try {
         const { stdout } = await exec(command);
         const [name, email, remoteOrigin, branch, commit, tagsOutput] = stdout
             .trim()
-            .split(delimiter)
+            .split(GIT_OUTPUT_DELIMITER)
             .map((x) => x.trim());
         // Parse tags - if multiple tags point to HEAD, they'll be on separate lines
         const tags = tagsOutput ? tagsOutput.split('\n').filter(Boolean) : [];
@@ -66,7 +118,7 @@ async function loadGitInfo(hasSecretToken) {
         const error = cause;
         throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
             cause,
-            data: { command, delimiter },
+            data: { command, delimiter: GIT_OUTPUT_DELIMITER },
             message: (error === null || error === void 0 ? void 0 : error.stderr) || error.message,
         });
     }
@@ -104,4 +156,214 @@ function parseGitUrl(remoteOrigin, stdout) {
         });
     }
 }
+/** Try to load git info from global git config */
+async function loadGlobalGitInfo() {
+    var _a, _b;
+    try {
+        const [nameResult, emailResult] = await Promise.all([
+            exec('git config --global user.name').catch(() => ({ stdout: '' })),
+            exec('git config --global user.email').catch(() => ({ stdout: '' })),
+        ]);
+        const name = (_a = nameResult.stdout) === null || _a === void 0 ? void 0 : _a.trim();
+        const email = (_b = emailResult.stdout) === null || _b === void 0 ? void 0 : _b.trim();
+        if (!name && !email) {
+            (0, ze_log_event_1.logFn)('warn', 'Global git config incomplete: both name and email are missing. Falling back to API user info.');
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Global git config incomplete: both name and email are missing',
+            });
+        }
+        if (!name) {
+            (0, ze_log_event_1.logFn)('warn', 'Global git config incomplete: user name is missing. Run: git config --global user.name "Your Name". Falling back to API user info.');
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Global git config incomplete: user name is missing',
+            });
+        }
+        if (!email) {
+            (0, ze_log_event_1.logFn)('warn', 'Global git config incomplete: user email is missing. Run: git config --global user.email "your@email.com". Falling back to API user info.');
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Global git config incomplete: user email is missing',
+            });
+        }
+        const { org, project } = await getAppNamingFromPackageJson(name);
+        const gitInfo = {
+            git: {
+                name,
+                email,
+                branch: generateBranchName('global-git'),
+                commit: 'no-git-commit',
+                tags: [],
+            },
+            app: {
+                org,
+                project,
+            },
+        };
+        logging_1.ze_log.git('Using global git config (no local repository)', gitInfo);
+        (0, ze_log_event_1.logFn)('warn', 'Configuration accepted for THIS BUILD ONLY.');
+        (0, ze_log_event_1.logFn)('warn', 'This manual configuration will NOT work for production deployments.');
+        (0, ze_log_event_1.logFn)('warn', 'Zephyr REQUIRES a proper git repository with remote origin to function correctly.');
+        (0, ze_log_event_1.logFn)('warn', 'Please set up git before your next deployment: https://docs.zephyr-cloud.io');
+        return gitInfo;
+    }
+    catch (error) {
+        throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+            message: 'Failed to load global git config',
+            cause: error,
+        });
+    }
+}
+/** Get user info from API endpoint instead of JWT decoding */
+async function getUserInfoFromAPI() {
+    const token = await (0, token_1.getToken)();
+    if (!token || !(0, login_1.isTokenStillValid)(token, 60)) {
+        throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+            message: 'No valid authentication token found. Please login first.',
+        });
+    }
+    const [ok, cause, response] = await (0, http_request_1.makeRequest)({
+        path: '/v2/user/me',
+        base: (0, zephyr_edge_contract_1.ZE_API_ENDPOINT)(),
+        query: {},
+    });
+    if (!ok) {
+        throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+            message: 'Failed to get user information from API. Please ensure you are logged in with a valid token.',
+            cause,
+        });
+    }
+    const userData = response.value;
+    logging_1.ze_log.git('Retrieved user info from API:', {
+        name: userData.name,
+        email: userData.email,
+    });
+    return userData;
+}
+/** Generate fallback git info when git is completely unavailable */
+async function getFallbackGitInfo() {
+    let userInfo;
+    try {
+        userInfo = await getUserInfoFromAPI();
+    }
+    catch (error) {
+        logging_1.ze_log.git('Failed to get user info from API:', error);
+        throw error;
+    }
+    const gitName = userInfo.name;
+    const gitEmail = userInfo.email;
+    if (is_ci_1.default) {
+        throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+            message: 'Git repository information is required in CI environments. Please ensure your CI workflow includes git repository with proper remote origin.',
+        });
+    }
+    const { org, project } = await getAppNamingFromPackageJson(userInfo.name);
+    const gitInfo = {
+        git: {
+            name: gitName,
+            email: gitEmail,
+            branch: generateBranchName('no-git', userInfo.id),
+            commit: `fallback-deployment-${Date.now()}`,
+            tags: [`deployed-by:${userInfo.id}`],
+        },
+        app: {
+            org,
+            project,
+        },
+    };
+    logging_1.ze_log.git('Using fallback git info (git not available)', gitInfo);
+    (0, ze_log_event_1.logFn)('warn', `Using organization "${org}" from authenticated user.`);
+    (0, ze_log_event_1.logFn)('warn', 'Configuration accepted for THIS BUILD ONLY.');
+    (0, ze_log_event_1.logFn)('warn', 'This manual configuration will NOT work for production deployments.');
+    (0, ze_log_event_1.logFn)('warn', 'Zephyr REQUIRES a proper git repository with remote origin to function correctly.');
+    (0, ze_log_event_1.logFn)('warn', 'Please set up git before your next deployment: https://docs.zephyr-cloud.io');
+    return gitInfo;
+}
+/** Sanitize string for use as org/project name */
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+}
+/** Get current directory name as project name */
+function getCurrentDirectoryName() {
+    const cwd = process.cwd();
+    const dirName = cwd.split(node_path_1.sep).pop() || 'untitled-project';
+    return sanitizeName(dirName);
+}
+/**
+ * Extract org, project, and app names from package.json structure for non-git
+ * environments
+ */
+async function getAppNamingFromPackageJson(tokenUserName) {
+    try {
+        const packageJson = await (0, ze_util_read_package_json_1.getPackageJson)(process.cwd());
+        const packageName = packageJson.name;
+        // Require JWT username for org - no fallback to avoid build loss
+        if (!tokenUserName) {
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Unable to determine organization: no authenticated user found. Please ensure you are logged in with a valid token.',
+            });
+        }
+        const org = sanitizeName(tokenUserName);
+        if (packageName.includes('@')) {
+            // Scoped package: @scope/name -> project: scope, app: name
+            const [scope, name] = packageName.split('/');
+            return {
+                org,
+                project: scope.replace('@', ''),
+                app: name,
+            };
+        }
+        // Check if we're in a monorepo
+        const monorepoInfo = await (0, detect_monorepo_1.detectMonorepo)(process.cwd());
+        if (monorepoInfo.type !== 'none') {
+            // We're in a monorepo
+            const rootPackageJson = await (0, detect_monorepo_1.getMonorepoRootPackageJson)(monorepoInfo.root);
+            if (rootPackageJson && rootPackageJson['name']) {
+                const rootName = rootPackageJson['name'];
+                // If root package is scoped, use the scope as project
+                if (rootName.includes('@')) {
+                    const [scope] = rootName.split('/');
+                    return {
+                        org,
+                        project: scope.replace('@', ''),
+                        app: packageName,
+                    };
+                }
+                // Use root package name as project
+                return {
+                    org,
+                    project: sanitizeName(rootName),
+                    app: packageName,
+                };
+            }
+            else {
+                // No root package.json or no name - use monorepo root directory name
+                const rootDirName = monorepoInfo.root.split(node_path_1.sep).pop() || 'monorepo';
+                return {
+                    org,
+                    project: sanitizeName(rootDirName),
+                    app: packageName,
+                };
+            }
+        }
+        // Not in a monorepo - single package
+        return {
+            org,
+            project: packageName,
+            app: packageName,
+        };
+    }
+    catch (_a) {
+        // No package.json: use directory name
+        const dirName = getCurrentDirectoryName();
+        if (!tokenUserName) {
+            throw new errors_1.ZephyrError(errors_1.ZeErrors.ERR_NO_GIT_INFO, {
+                message: 'Unable to determine organization: no authenticated user found and no package.json available. Please ensure you are logged in with a valid token.',
+            });
+        }
+        return {
+            org: sanitizeName(tokenUserName),
+            project: dirName,
+            app: dirName,
+        };
+    }
+}
 //# sourceMappingURL=ze-util-get-git-info.js.map