@virtengine/openfleet 0.26.1 → 0.26.3

package/ui/modules/settings-schema.js

@@ -104,12 +104,12 @@ export const SETTINGS_SCHEMA = [
   // ── Kanban / Tasks ─────────────────────────────────────────
   { key: "KANBAN_BACKEND",                 label: "Kanban Backend",             category: "kanban", type: "select", defaultVal: "internal", options: ["internal", "vk", "github", "jira"], description: "Task management backend. 'internal' uses built-in store, 'github' syncs with GitHub Issues/Projects." },
   { key: "KANBAN_SYNC_POLICY",             label: "Sync Policy",                category: "kanban", type: "select", defaultVal: "internal-primary", options: ["internal-primary", "bidirectional"], description: "How tasks sync between internal store and external backend." },
-  { key: "CODEX_MONITOR_TASK_LABEL",       label: "Task Label",                 category: "kanban", type: "string", defaultVal: "openfleet", description: "GitHub label used to scope which issues are managed by Codex Monitor." },
-  { key: "CODEX_MONITOR_ENFORCE_TASK_LABEL", label: "Enforce Task Label",       category: "kanban", type: "boolean", defaultVal: true, description: "Only pick up issues that have the task label. Prevents processing unrelated issues." },
+  { key: "OPENFLEET_TASK_LABEL",       label: "Task Label",                 category: "kanban", type: "string", defaultVal: "openfleet", description: "GitHub label used to scope which issues are managed by OpenFleet." },
+  { key: "OPENFLEET_ENFORCE_TASK_LABEL", label: "Enforce Task Label",       category: "kanban", type: "boolean", defaultVal: true, description: "Only pick up issues that have the task label. Prevents processing unrelated issues." },
   { key: "STALE_TASK_AGE_HOURS",           label: "Stale Task Age",             category: "kanban", type: "number", defaultVal: 3, min: 1, max: 168, unit: "hours", description: "Hours before an in-progress task with no activity is considered stale and eligible for recovery." },
   { key: "TASK_PLANNER_MODE",              label: "Task Planner Mode",          category: "kanban", type: "select", defaultVal: "kanban", options: ["kanban", "codex-sdk", "disabled"], description: "How the autonomous task planner operates. 'disabled' turns off automatic task generation." },
   { key: "TASK_PLANNER_DEDUP_HOURS",       label: "Planner Dedup Window",       category: "kanban", type: "number", defaultVal: 6, min: 1, max: 72, unit: "hours", description: "Hours to look back for duplicate task detection.", advanced: true },
-  { key: "CODEX_MONITOR_PROMPT_PLANNER",  label: "Planner Prompt Path",         category: "advanced", type: "string", description: "Override the task planner prompt file path.", advanced: true },
+  { key: "OPENFLEET_PROMPT_PLANNER",  label: "Planner Prompt Path",         category: "advanced", type: "string", description: "Override the task planner prompt file path.", advanced: true },
 
   // ── GitHub / Git ─────────────────────────────────────────
   { key: "GITHUB_TOKEN",                   label: "GitHub Token",               category: "github", type: "secret", sensitive: true, description: "Personal access token or fine-grained token for GitHub API. Required for GitHub kanban backend." },
@@ -157,7 +157,7 @@ export const SETTINGS_SCHEMA = [
   { key: "CONTAINER_CPU_LIMIT",            label: "CPU Limit",                  category: "security", type: "string", description: "Container CPU limit (e.g., '2', '1.5'). Leave empty for no limit.", validate: "^\\d+\\.?\\d*$" },
 
   // ── Sentinel / Reliability ─────────────────────────────────
-  { key: "CODEX_MONITOR_SENTINEL_AUTO_START", label: "Auto-Start Sentinel",     category: "sentinel", type: "boolean", defaultVal: false, description: "Automatically start the sentinel watchdog on boot." },
+  { key: "OPENFLEET_SENTINEL_AUTO_START", label: "Auto-Start Sentinel",     category: "sentinel", type: "boolean", defaultVal: false, description: "Automatically start the sentinel watchdog on boot." },
   { key: "SENTINEL_AUTO_RESTART_MONITOR",  label: "Auto-Restart on Crash",      category: "sentinel", type: "boolean", defaultVal: true, description: "Automatically restart the monitor process if it crashes." },
   { key: "SENTINEL_CRASH_LOOP_THRESHOLD",  label: "Crash Loop Threshold",       category: "sentinel", type: "number", defaultVal: 3, min: 2, max: 20, description: "Number of crashes within the window before declaring a crash loop." },
   { key: "SENTINEL_CRASH_LOOP_WINDOW_MIN", label: "Crash Loop Window",          category: "sentinel", type: "number", defaultVal: 10, min: 2, max: 60, unit: "min", description: "Rolling time window for crash loop detection." },
@@ -165,11 +165,11 @@ export const SETTINGS_SCHEMA = [
   { key: "SENTINEL_REPAIR_TIMEOUT_MIN",    label: "Repair Timeout",             category: "sentinel", type: "number", defaultVal: 20, min: 5, max: 120, unit: "min", description: "Maximum time the repair agent can run." },
 
   // ── Agent Hooks ────────────────────────────────────────────
-  { key: "CODEX_MONITOR_HOOK_PROFILE",     label: "Hook Profile",               category: "hooks", type: "select", defaultVal: "strict", options: ["strict", "balanced", "lightweight", "none"], description: "Pre-configured hook intensity. 'strict' runs all checks, 'none' disables hooks." },
-  { key: "CODEX_MONITOR_HOOK_TARGETS",     label: "Hook Targets",               category: "hooks", type: "string", defaultVal: "codex,claude,copilot", description: "Comma-separated list of agent SDKs to install hooks for.", validate: "^[a-z,]+$" },
-  { key: "CODEX_MONITOR_HOOKS_ENABLED",    label: "Enable Hooks",               category: "hooks", type: "boolean", defaultVal: true, description: "Enable agent lifecycle hook scaffolding." },
-  { key: "CODEX_MONITOR_HOOKS_OVERWRITE",  label: "Overwrite Existing",         category: "hooks", type: "boolean", defaultVal: false, description: "Overwrite existing hook files when installing. Use with caution." },
-  { key: "CODEX_MONITOR_HOOKS_BUILTINS_MODE", label: "Built-ins Mode",          category: "hooks", type: "select", defaultVal: "force", options: ["force", "auto", "off"], description: "How built-in hooks are managed. 'force' always installs, 'auto' only if missing." },
+  { key: "OPENFLEET_HOOK_PROFILE",     label: "Hook Profile",               category: "hooks", type: "select", defaultVal: "strict", options: ["strict", "balanced", "lightweight", "none"], description: "Pre-configured hook intensity. 'strict' runs all checks, 'none' disables hooks." },
+  { key: "OPENFLEET_HOOK_TARGETS",     label: "Hook Targets",               category: "hooks", type: "string", defaultVal: "codex,claude,copilot", description: "Comma-separated list of agent SDKs to install hooks for.", validate: "^[a-z,]+$" },
+  { key: "OPENFLEET_HOOKS_ENABLED",    label: "Enable Hooks",               category: "hooks", type: "boolean", defaultVal: true, description: "Enable agent lifecycle hook scaffolding." },
+  { key: "OPENFLEET_HOOKS_OVERWRITE",  label: "Overwrite Existing",         category: "hooks", type: "boolean", defaultVal: false, description: "Overwrite existing hook files when installing. Use with caution." },
+  { key: "OPENFLEET_HOOKS_BUILTINS_MODE", label: "Built-ins Mode",          category: "hooks", type: "select", defaultVal: "force", options: ["force", "auto", "off"], description: "How built-in hooks are managed. 'force' always installs, 'auto' only if missing." },
 
   // ── Logging / Monitoring ────────────────────────────────────
   { key: "AGENT_WORK_LOGGING_ENABLED",     label: "Work Logging",               category: "logging", type: "boolean", defaultVal: true, description: "Enable structured agent work logging with transcripts." },
@@ -213,7 +213,7 @@ export function getGroupedSettings(includeAdvanced = false) {
  */
 export function validateSetting(def, value) {
   if (value === "" || value == null) return { valid: true };
-  if (def.key === "CODEX_MONITOR_HOOK_TARGETS") {
+  if (def.key === "OPENFLEET_HOOK_TARGETS") {
     const targets = String(value || "")
       .split(",")
       .map((entry) => entry.trim().toLowerCase())

package/ui/styles/variables.css

@@ -1,5 +1,5 @@
 /* ─── VirtEngine Control Center — CSS Custom Properties ─── */
-/* Tuned for a CodexMonitor-style desktop + responsive UI */
+/* Tuned for a OpenFleet-style desktop + responsive UI */
 
 :root {
   /* Typography */

package/ui-server.mjs

@@ -75,8 +75,8 @@ let _configSchema = null;
 let _configValidator = null;
 
 function resolveConfigPath() {
-  return process.env.CODEX_MONITOR_CONFIG_PATH
-    ? resolve(process.env.CODEX_MONITOR_CONFIG_PATH)
+  return process.env.OPENFLEET_CONFIG_PATH
+    ? resolve(process.env.OPENFLEET_CONFIG_PATH)
     : resolve(__dirname, "openfleet.config.json");
 }
 
@@ -165,7 +165,7 @@ function coerceSettingValue(def, value, propSchema) {
       .split(",")
       .map((part) => part.trim())
       .filter(Boolean);
-    if (def?.key === "CODEX_MONITOR_HOOK_TARGETS") {
+    if (def?.key === "OPENFLEET_HOOK_TARGETS") {
       parts = parts.map((part) => part.toLowerCase());
       if (parts.includes("all")) {
         const allowed = Array.isArray(propSchema?.items?.enum)
@@ -213,7 +213,7 @@ function getSchemaProperty(schema, pathParts) {
 
 const ROOT_SKIP_ENV_KEYS = new Set([]);
 const ROOT_OVERRIDE_MAP = {
-  CODEX_MONITOR_MODE: "mode",
+  OPENFLEET_MODE: "mode",
   TASK_PLANNER_MODE: "plannerMode",
   EXECUTOR_DISTRIBUTION: "distribution",
 };
@@ -274,8 +274,8 @@ function mapEnvKeyToConfigPath(key, schema) {
     const sub = toCamelCaseFromEnv(rest);
     if (schema.properties.failover.properties[sub]) return buildConfigPath(["failover", sub]);
   }
-  if (envKey.startsWith("CODEX_MONITOR_PROMPT_") && schema.properties.agentPrompts?.properties) {
-    const rest = envKey.slice("CODEX_MONITOR_PROMPT_".length);
+  if (envKey.startsWith("OPENFLEET_PROMPT_") && schema.properties.agentPrompts?.properties) {
+    const rest = envKey.slice("OPENFLEET_PROMPT_".length);
     const sub = toCamelCaseFromEnv(rest);
     if (schema.properties.agentPrompts.properties[sub]) {
       return buildConfigPath(["agentPrompts", sub]);
@@ -293,10 +293,10 @@ function mapEnvKeyToConfigPath(key, schema) {
     }
   }
   const hookProfileMap = {
-    CODEX_MONITOR_HOOK_PROFILE: ["hookProfiles", "profile"],
-    CODEX_MONITOR_HOOK_TARGETS: ["hookProfiles", "targets"],
-    CODEX_MONITOR_HOOKS_ENABLED: ["hookProfiles", "enabled"],
-    CODEX_MONITOR_HOOKS_OVERWRITE: ["hookProfiles", "overwriteExisting"],
+    OPENFLEET_HOOK_PROFILE: ["hookProfiles", "profile"],
+    OPENFLEET_HOOK_TARGETS: ["hookProfiles", "targets"],
+    OPENFLEET_HOOKS_ENABLED: ["hookProfiles", "enabled"],
+    OPENFLEET_HOOKS_OVERWRITE: ["hookProfiles", "overwriteExisting"],
   };
   if (hookProfileMap[envKey]) {
     const pathParts = hookProfileMap[envKey];
@@ -470,10 +470,10 @@ const SETTINGS_KNOWN_KEYS = [
   "CODEX_MODEL_PROFILE_M_PROVIDER", "CODEX_MODEL_PROFILE_M_MODEL", "CODEX_MODEL_PROFILE_M_BASE_URL", "CODEX_MODEL_PROFILE_M_API_KEY",
   "CODEX_SUBAGENT_MODEL", "ANTHROPIC_API_KEY", "CLAUDE_MODEL",
   "COPILOT_MODEL", "COPILOT_CLI_TOKEN",
-  "KANBAN_BACKEND", "KANBAN_SYNC_POLICY", "CODEX_MONITOR_TASK_LABEL",
-  "CODEX_MONITOR_ENFORCE_TASK_LABEL", "STALE_TASK_AGE_HOURS",
+  "KANBAN_BACKEND", "KANBAN_SYNC_POLICY", "OPENFLEET_TASK_LABEL",
+  "OPENFLEET_ENFORCE_TASK_LABEL", "STALE_TASK_AGE_HOURS",
   "TASK_PLANNER_MODE", "TASK_PLANNER_DEDUP_HOURS",
-  "CODEX_MONITOR_PROMPT_PLANNER",
+  "OPENFLEET_PROMPT_PLANNER",
   "GITHUB_TOKEN", "GITHUB_REPOSITORY", "GITHUB_PROJECT_MODE",
   "GITHUB_PROJECT_NUMBER", "GITHUB_DEFAULT_ASSIGNEE", "GITHUB_AUTO_ASSIGN_CREATOR",
   "GITHUB_PROJECT_WEBHOOK_PATH", "GITHUB_PROJECT_WEBHOOK_SECRET", "GITHUB_PROJECT_WEBHOOK_REQUIRE_SIGNATURE",
@@ -488,12 +488,12 @@ const SETTINGS_KNOWN_KEYS = [
   "CODEX_SANDBOX", "CODEX_FEATURES_BWRAP", "CODEX_SANDBOX_PERMISSIONS", "CODEX_SANDBOX_WRITABLE_ROOTS",
   "CONTAINER_ENABLED", "CONTAINER_RUNTIME", "CONTAINER_IMAGE",
   "CONTAINER_TIMEOUT_MS", "MAX_CONCURRENT_CONTAINERS", "CONTAINER_MEMORY_LIMIT", "CONTAINER_CPU_LIMIT",
-  "CODEX_MONITOR_SENTINEL_AUTO_START", "SENTINEL_AUTO_RESTART_MONITOR",
+  "OPENFLEET_SENTINEL_AUTO_START", "SENTINEL_AUTO_RESTART_MONITOR",
   "SENTINEL_CRASH_LOOP_THRESHOLD", "SENTINEL_CRASH_LOOP_WINDOW_MIN",
   "SENTINEL_REPAIR_AGENT_ENABLED", "SENTINEL_REPAIR_TIMEOUT_MIN",
-  "CODEX_MONITOR_HOOK_PROFILE", "CODEX_MONITOR_HOOK_TARGETS",
-  "CODEX_MONITOR_HOOKS_ENABLED", "CODEX_MONITOR_HOOKS_OVERWRITE",
-  "CODEX_MONITOR_HOOKS_BUILTINS_MODE",
+  "OPENFLEET_HOOK_PROFILE", "OPENFLEET_HOOK_TARGETS",
+  "OPENFLEET_HOOKS_ENABLED", "OPENFLEET_HOOKS_OVERWRITE",
+  "OPENFLEET_HOOKS_BUILTINS_MODE",
   "AGENT_WORK_LOGGING_ENABLED", "AGENT_WORK_ANALYZER_ENABLED",
   "AGENT_SESSION_LOG_RETENTION", "AGENT_ERROR_LOOP_THRESHOLD",
   "AGENT_STUCK_THRESHOLD_MS", "LOG_MAX_SIZE_MB",
@@ -3807,8 +3807,9 @@ async function handleStatic(req, res, url) {
 export async function startTelegramUiServer(options = {}) {
   if (uiServer) return uiServer;
 
-  const port = Number(options.port || getDefaultPort());
-  if (!port) return null;
+  const rawPort = options.port ?? getDefaultPort();
+  const port = Number(rawPort);
+  if (!Number.isFinite(port) || port < 0) return null;
 
   injectUiDependencies(options.dependencies || {});
 

package/update-check.mjs

@@ -8,9 +8,9 @@
  *       auto-installs updates and restarts the process. Zero user interaction.
  *
  * Respects:
- *   - CODEX_MONITOR_SKIP_UPDATE_CHECK=1 — disable startup check
- *   - CODEX_MONITOR_SKIP_AUTO_UPDATE=1 — disable polling auto-update
- *   - CODEX_MONITOR_UPDATE_INTERVAL_MS — override poll interval (default 10 min)
+ *   - OPENFLEET_SKIP_UPDATE_CHECK=1 — disable startup check
+ *   - OPENFLEET_SKIP_AUTO_UPDATE=1 — disable polling auto-update
+ *   - OPENFLEET_UPDATE_INTERVAL_MS — override poll interval (default 10 min)
  *   - Caches the last check timestamp so we don't query npm too aggressively
  */
 
@@ -20,6 +20,7 @@ import { readFileSync, existsSync } from "node:fs";
 import { resolve, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline";
+import os from "node:os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_NAME = "@virtengine/openfleet";
@@ -28,9 +29,14 @@ const STARTUP_CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1 hour (startup notice)
 const AUTO_UPDATE_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes (polling loop)
 
 function runNpmCommand(args, options = {}) {
+  // Default cwd to the user home directory so that npm never inherits a
+  // deleted working directory (e.g. a stale git worktree), which would cause
+  // Node's uv_cwd to throw ENOENT before npm even parses its arguments.
+  const safeOptions = { cwd: os.homedir(), ...options };
+
   const npmExecPath = process.env.npm_execpath;
   if (npmExecPath && existsSync(npmExecPath)) {
-    return execFileSync(process.execPath, [npmExecPath, ...args], options);
+    return execFileSync(process.execPath, [npmExecPath, ...args], safeOptions);
   }
 
   const nodeBinDir = dirname(process.execPath);
@@ -45,12 +51,12 @@ function runNpmCommand(args, options = {}) {
 
   for (const candidate of candidates) {
     if (existsSync(candidate)) {
-      return execFileSync(candidate, args, options);
+      return execFileSync(candidate, args, safeOptions);
     }
   }
 
   const fallback = process.platform === "win32" ? "npm.cmd" : "npm";
-  return execFileSync(fallback, args, options);
+  return execFileSync(fallback, args, safeOptions);
 }
 
 // ── Semver comparison ────────────────────────────────────────────────────────
@@ -124,7 +130,7 @@ async function fetchLatestVersion() {
  * Called on startup — must never throw or delay the main process.
  */
 export async function checkForUpdate(currentVersion) {
-  if (process.env.CODEX_MONITOR_SKIP_UPDATE_CHECK) return;
+  if (process.env.OPENFLEET_SKIP_UPDATE_CHECK) return;
 
   try {
     // Rate-limit: at most once per hour
@@ -240,13 +246,13 @@ let cleanupHandlersRegistered = false;
  * @param {number}   [opts.parentPid]  - Parent process PID to monitor (default: process.ppid)
  */
 export function startAutoUpdateLoop(opts = {}) {
-  if (process.env.CODEX_MONITOR_SKIP_AUTO_UPDATE === "1") {
-    console.log("[auto-update] Disabled via CODEX_MONITOR_SKIP_AUTO_UPDATE=1");
+  if (process.env.OPENFLEET_SKIP_AUTO_UPDATE === "1") {
+    console.log("[auto-update] Disabled via OPENFLEET_SKIP_AUTO_UPDATE=1");
     return;
   }
 
   const intervalMs =
-    Number(process.env.CODEX_MONITOR_UPDATE_INTERVAL_MS) ||
+    Number(process.env.OPENFLEET_UPDATE_INTERVAL_MS) ||
     opts.intervalMs ||
     AUTO_UPDATE_INTERVAL_MS;
   const onRestart = opts.onRestart || (() => process.exit(0));

package/ve-orchestrator.ps1

@@ -969,7 +969,7 @@ function Initialize-CISweepConfig {
     $script:CopilotCloudDisableOnRateLimit = Get-EnvBool -Name "COPILOT_CLOUD_DISABLE_ON_RATE_LIMIT" -Default $true
     $envCopilotLocalResolution = Get-EnvFallback -Name "COPILOT_LOCAL_RESOLUTION"
     $script:CopilotLocalResolution = if ($envCopilotLocalResolution) { $envCopilotLocalResolution } else { "agent" }
-    $script:CodexMonitorTaskUpstream = Get-EnvString -Name "CODEX_MONITOR_TASK_UPSTREAM" -Default "origin/ve/openfleet-generic"
+    $script:OpenFleetTaskUpstream = Get-EnvString -Name "OPENFLEET_TASK_UPSTREAM" -Default "origin/ve/openfleet-generic"
 
     # Branch routing scope map (v0.8) — maps conventional commit scopes to upstream branches
     $script:BranchRoutingScopeMap = @{}
@@ -1530,10 +1530,10 @@ function Extract-UpstreamFromText {
     return Normalize-BranchName -Branch $match.Groups[1].Value
 }
 
-function Test-IsCodexMonitorTask {
+function Test-IsOpenFleetTask {
     param([Parameter(Mandatory)][object]$Task)
     $text = (Get-TaskTextBlob -Task $Task).ToLowerInvariant()
-    if ($text -match "openfleet|codex monitor|@virtengine/openfleet|scripts/openfleet") { return $true }
+    if ($text -match "openfleet|OpenFleet|@virtengine/openfleet|scripts/openfleet") { return $true }
     return $false
 }
 
@@ -1637,8 +1637,8 @@ function Get-TaskUpstreamBranch {
     $fromScope = Resolve-BranchFromScopeMap -Task $Task
     if ($fromScope) { return $fromScope }
 
-    if (Test-IsCodexMonitorTask -Task $Task) {
-        return $script:CodexMonitorTaskUpstream
+    if (Test-IsOpenFleetTask -Task $Task) {
+        return $script:OpenFleetTaskUpstream
     }
 
     return $script:VK_TARGET_BRANCH
@@ -5926,7 +5926,7 @@ function Test-DirtyPRFileOverlap {
         'ci'           = @('.github/', 'Makefile', 'make/')
         'ml'           = @('ml/')
         'deps'         = @('go.mod', 'go.sum', 'vendor/')
-        'codexmonitor' = @('scripts/openfleet/')
+        'OpenFleet' = @('scripts/openfleet/')
     }
 
     $titleLower = $TaskTitle.ToLower()

package/whatsapp-channel.mjs

@@ -33,7 +33,7 @@ const whatsappChatId = process.env.WHATSAPP_CHAT_ID || "";
 const assistantName =
   process.env.WHATSAPP_ASSISTANT_NAME ||
   process.env.PROJECT_NAME ||
-  "Codex Monitor";
+  "OpenFleet";
 const storeDir = resolve(
   process.env.WHATSAPP_STORE_DIR ||
     resolve(repoRoot, ".cache", "whatsapp-store"),
@@ -229,7 +229,7 @@ async function connectInternal(onFirstOpen) {
     },
     printQRInTerminal: false,
     logger: silentLogger,
-    browser: b.Browsers?.macOS?.("Chrome") || ["Codex Monitor", "Chrome", "1.0"],
+    browser: b.Browsers?.macOS?.("Chrome") || ["OpenFleet", "Chrome", "1.0"],
   });
 
   sock.ev.on("connection.update", (update) => {
@@ -452,7 +452,7 @@ export async function runWhatsAppAuth(mode = "qr") {
     },
     printQRInTerminal: false,
     logger: silentLogger,
-    browser: b.Browsers?.macOS?.("Chrome") || ["Codex Monitor", "Chrome", "1.0"],
+    browser: b.Browsers?.macOS?.("Chrome") || ["OpenFleet", "Chrome", "1.0"],
   });
 
   let pairingRequested = false;

package/worktree-manager.mjs

@@ -177,7 +177,7 @@ function detectGitTopLevel(candidatePath) {
  * Resolve the best repository root for singleton initialization.
  * Priority:
  *   1) explicit repoRoot arg
- *   2) VE_REPO_ROOT / CODEX_MONITOR_REPO_ROOT env
+ *   2) VE_REPO_ROOT / OPENFLEET_REPO_ROOT env
  *   3) current working directory's git top-level
  *   4) module-relative git top-level (useful for local dev)
  *   5) process.cwd() fallback
@@ -189,7 +189,7 @@ function resolveDefaultRepoRoot(repoRoot) {
   if (repoRoot) return resolve(repoRoot);
 
   const envRoot =
-    process.env.VE_REPO_ROOT || process.env.CODEX_MONITOR_REPO_ROOT || "";
+    process.env.VE_REPO_ROOT || process.env.OPENFLEET_REPO_ROOT || "";
   const fromEnv = detectGitTopLevel(envRoot) || (envRoot ? resolve(envRoot) : null);
   if (fromEnv) return fromEnv;