opendevbrowser 0.0.31 → 0.0.33

package/dist/{chunk-2I3YS3DV.js → chunk-FDBUB7BM.js}

@@ -2,10 +2,10 @@ import {
   CLI_COMMANDS,
   VALID_EQUALS_FLAGS,
   VALID_FLAGS
-} from "./chunk-6B5WAQV7.js";
+} from "./chunk-27W46IKI.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
+} from "./chunk-7BNU6DFI.js";
 
 // src/cli/args.ts
 var CLI_COMMAND_SET = new Set(CLI_COMMANDS);
@@ -74,8 +74,12 @@ function parseTransport(args) {
 var VALID_FLAG_SET = new Set(VALID_FLAGS);
 var VALID_EQUALS_FLAG_SET = new Set(VALID_EQUALS_FLAGS);
 var SIGNED_VALUE_FLAG_SET = /* @__PURE__ */ new Set(["--dy"]);
+var PASSTHROUGH_VALUE_FLAG_SET = /* @__PURE__ */ new Set(["--flag"]);
 var SIGNED_INTEGER_VALUE = /^-\d+$/;
 function shouldSkipValueToken(flag, value) {
+  if (PASSTHROUGH_VALUE_FLAG_SET.has(flag) && value !== void 0) {
+    return true;
+  }
   if (!VALID_EQUALS_FLAG_SET.has(flag) || value === void 0) {
     return false;
   }
@@ -223,4 +227,4 @@ export {
   parseArgs,
   detectOutputFormat
 };
-//# sourceMappingURL=chunk-2I3YS3DV.js.map
+//# sourceMappingURL=chunk-FDBUB7BM.js.map

package/dist/chunk-FDBUB7BM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/args.ts"],"sourcesContent":["import { createUsageError } from \"./errors\";\nimport {\n  CLI_COMMANDS,\n  VALID_EQUALS_FLAGS,\n  VALID_FLAGS\n} from \"../public-surface/generated-manifest\";\nimport type { PublicSurfaceCliCommandName } from \"../public-surface/source\";\n\nconst CLI_COMMAND_SET = new Set<string>(CLI_COMMANDS);\n\nexport { CLI_COMMANDS, VALID_EQUALS_FLAGS, VALID_FLAGS };\n\nexport type CliCommand = PublicSurfaceCliCommandName;\nexport type InstallMode = \"global\" | \"local\";\nexport type SkillsMode = \"global\" | \"local\" | \"none\";\nexport type OutputFormat = \"text\" | \"json\" | \"stream-json\";\nexport type TransportMode = \"relay\" | \"native\";\n\nexport interface ParsedArgs {\n  command: CliCommand;\n  mode?: InstallMode;\n  withConfig: boolean;\n  noPrompt: boolean;\n  noInteractive: boolean;\n  quiet: boolean;\n  outputFormat: OutputFormat;\n  transport: TransportMode;\n  skillsMode: SkillsMode;\n  fullInstall: boolean;\n  rawArgs: string[];\n}\n\nconst SHORT_FLAGS: Record<string, string> = {\n  \"-g\": \"--global\",\n  \"-l\": \"--local\",\n  \"-u\": \"--update\",\n  \"-h\": \"--help\",\n  \"-v\": \"--version\",\n  \"-f\": \"--full\"\n};\n\nfunction expandShortFlags(args: string[]): string[] {\n  return args.map((arg) => SHORT_FLAGS[arg] ?? arg);\n}\n\nfunction parseSkillsMode(args: string[]): SkillsMode {\n  const hasLocal = args.includes(\"--skills-local\");\n  const hasGlobal = args.includes(\"--skills-global\");\n  if (hasLocal && hasGlobal) {\n    throw createUsageError(\"Choose either --skills-local or --skills-global.\");\n  }\n  if (args.includes(\"--no-skills\")) {\n    return \"none\";\n  }\n  if (hasLocal) {\n    return \"local\";\n  }\n  if (hasGlobal) {\n    return \"global\";\n  }\n  return \"global\";\n}\n\nfunction parseOutputFormat(args: string[]): OutputFormat {\n  const outputFlag = args.find((arg) => arg.startsWith(\"--output-format\"));\n  if (!outputFlag) {\n    return \"text\";\n  }\n\n  let value: string | undefined;\n  if (outputFlag.includes(\"=\")) {\n    value = outputFlag.split(\"=\", 2)[1];\n  } else {\n    const index = args.indexOf(outputFlag);\n    value = index >= 0 ? args[index + 1] : undefined;\n  }\n\n  if (value === \"text\" || value === \"json\" || value === \"stream-json\") {\n    return value;\n  }\n\n  throw createUsageError(`Invalid --output-format: ${value ?? \"missing\"}`);\n}\n\nfunction parseTransport(args: string[]): TransportMode {\n  const transportFlag = args.find((arg) => arg.startsWith(\"--transport\"));\n  if (!transportFlag) {\n    return \"relay\";\n  }\n\n  let value: string | undefined;\n  if (transportFlag.includes(\"=\")) {\n    value = transportFlag.split(\"=\", 2)[1];\n  } else {\n    const index = args.indexOf(transportFlag);\n    value = index >= 0 ? args[index + 1] : undefined;\n  }\n\n  if (value === \"relay\" || value === \"native\") {\n    return value;\n  }\n\n  throw createUsageError(`Invalid --transport: ${value ?? \"missing\"}`);\n}\n\nconst VALID_FLAG_SET = new Set<string>(VALID_FLAGS);\nconst VALID_EQUALS_FLAG_SET = new Set<string>(VALID_EQUALS_FLAGS);\nconst SIGNED_VALUE_FLAG_SET = new Set<string>([\"--dy\"]);\nconst PASSTHROUGH_VALUE_FLAG_SET = new Set<string>([\"--flag\"]);\nconst SIGNED_INTEGER_VALUE = /^-\\d+$/;\n\nfunction shouldSkipValueToken(flag: string, value: string | undefined): boolean {\n  if (PASSTHROUGH_VALUE_FLAG_SET.has(flag) && value !== undefined) {\n    return true;\n  }\n  if (!VALID_EQUALS_FLAG_SET.has(flag) || value === undefined) {\n    return false;\n  }\n  if (!value.startsWith(\"-\")) {\n    return true;\n  }\n  return SIGNED_VALUE_FLAG_SET.has(flag) && SIGNED_INTEGER_VALUE.test(value);\n}\n\nexport function parseArgs(argv: string[]): ParsedArgs {\n  let args = expandShortFlags(argv.slice(2));\n  let commandOverride: CliCommand | null = null;\n\n  if (args[0] && !args[0].startsWith(\"-\")) {\n    const candidate = args[0];\n    if (CLI_COMMAND_SET.has(candidate)) {\n      commandOverride = candidate as CliCommand;\n      args = args.slice(1);\n    } else {\n      throw createUsageError(`Unknown command: ${candidate}`);\n    }\n  }\n  const hasGlobal = args.includes(\"--global\");\n  const hasLocal = args.includes(\"--local\");\n  if (hasGlobal && hasLocal) {\n    throw createUsageError(\"Choose either --global or --local.\");\n  }\n\n  const skillsMode = parseSkillsMode(args);\n  const fullInstall = args.includes(\"--full\");\n  const outputFormat = parseOutputFormat(args);\n  const transport = commandOverride === \"annotate\" ? \"relay\" : parseTransport(args);\n\n  if (commandOverride === \"help\" || args.includes(\"--help\") || args.includes(\"-h\")) {\n    return {\n      command: \"help\",\n      withConfig: false,\n      noPrompt: false,\n      noInteractive: false,\n      quiet: false,\n      outputFormat,\n      transport,\n      skillsMode,\n      fullInstall,\n      rawArgs: args\n    };\n  }\n\n  if (commandOverride === \"version\" || args.includes(\"--version\") || args.includes(\"-v\")) {\n    return {\n      command: \"version\",\n      withConfig: false,\n      noPrompt: false,\n      noInteractive: false,\n      quiet: false,\n      outputFormat,\n      transport,\n      skillsMode,\n      fullInstall,\n      rawArgs: args\n    };\n  }\n\n  if (commandOverride === \"update\" || args.includes(\"--update\")) {\n    const mode = args.includes(\"--global\") ? \"global\" : args.includes(\"--local\") ? \"local\" : undefined;\n    return {\n      command: \"update\",\n      mode,\n      withConfig: false,\n      noPrompt: false,\n      noInteractive: false,\n      quiet: false,\n      outputFormat,\n      transport,\n      skillsMode,\n      fullInstall,\n      rawArgs: args\n    };\n  }\n\n  if (commandOverride === \"uninstall\" || args.includes(\"--uninstall\")) {\n    const mode = args.includes(\"--global\") ? \"global\" : args.includes(\"--local\") ? \"local\" : undefined;\n    const noPrompt = args.includes(\"--no-prompt\") || args.includes(\"--no-interactive\");\n    return {\n      command: \"uninstall\",\n      mode,\n      withConfig: false,\n      noPrompt,\n      noInteractive: noPrompt,\n      quiet: args.includes(\"--quiet\"),\n      outputFormat,\n      transport,\n      skillsMode,\n      fullInstall,\n      rawArgs: args\n    };\n  }\n\n  const withConfig = args.includes(\"--with-config\") || fullInstall;\n  const noPrompt = args.includes(\"--no-prompt\") || args.includes(\"--no-interactive\");\n  const noInteractive = args.includes(\"--no-interactive\") || noPrompt;\n  const quiet = args.includes(\"--quiet\");\n\n  let mode: InstallMode | undefined;\n  if (args.includes(\"--global\")) {\n    mode = \"global\";\n  } else if (args.includes(\"--local\")) {\n    mode = \"local\";\n  } else if (noPrompt) {\n    mode = \"global\";\n  }\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index] ?? \"\";\n    if (arg.startsWith(\"--\") && !VALID_FLAG_SET.has(arg)) {\n      if (arg.includes(\"=\")) {\n        const baseFlag = arg.split(\"=\", 2)[0] ?? \"\";\n        if (VALID_EQUALS_FLAG_SET.has(baseFlag)) {\n          continue;\n        }\n      }\n      throw createUsageError(`Unknown flag: ${arg}`);\n    }\n    if (arg.startsWith(\"-\") && !arg.startsWith(\"--\") && !SHORT_FLAGS[arg]) {\n      throw createUsageError(`Unknown flag: ${arg}`);\n    }\n    if (shouldSkipValueToken(arg, args[index + 1])) {\n      index += 1;\n    }\n  }\n\n  return {\n    command: commandOverride ?? \"install\",\n    mode,\n    withConfig,\n    noPrompt,\n    noInteractive,\n    quiet,\n    outputFormat,\n    transport,\n    skillsMode,\n    fullInstall,\n    rawArgs: args\n  };\n}\n\nexport function detectOutputFormat(argv: string[]): OutputFormat {\n  const args = expandShortFlags(argv.slice(2));\n  try {\n    return parseOutputFormat(args);\n  } catch {\n    return \"text\";\n  }\n}\n\nexport function detectQuiet(argv: string[]): boolean {\n  const args = expandShortFlags(argv.slice(2));\n  return args.includes(\"--quiet\");\n}\n"],"mappings":"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","names":["mode","noPrompt"]}

package/dist/{chunk-COAOWH3G.js → chunk-HMRANSDX.js}

@@ -7,7 +7,7 @@ import {
   readCookiesFromSource,
   resolveBundledProviderRuntime,
   resolveSessionRelayRoute
-} from "./chunk-QOMWCRE3.js";
+} from "./chunk-EOX6U6Q4.js";
 import {
   loadGlobalConfig,
   resolveConfig
@@ -24,12 +24,12 @@ import {
   runProductVideoWorkflow,
   runResearchWorkflow,
   runShoppingWorkflow
-} from "./chunk-4BEJVZRK.js";
+} from "./chunk-FBKPDILE.js";
 import {
   buildBlockerArtifacts,
   classifyBlockerSignal,
   redactSensitive
-} from "./chunk-WHQZBUNY.js";
+} from "./chunk-3WLCWHIV.js";
 
 // src/cli/utils/http.ts
 var DEFAULT_HTTP_TIMEOUT_MS = 5e3;
@@ -148,12 +148,30 @@ async function readResponseJsonWithTimeout(response, signal, timeoutMs) {
   return await readResponseBodyWithTimeout(response, signal, timeoutMs, () => response.json());
 }
 
+// src/cli/daemon-mismatch.ts
+var DAEMON_FINGERPRINT_MISMATCH_REASON = "daemon_fingerprint_mismatch";
+var STATUS_PREFLIGHT_COMMAND = "opendevbrowser status --daemon --output-format json";
+var FINGERPRINT_CURRENT_ASSERTION = "data.fingerprintCurrent === true";
+var formatPid = (pid) => {
+  return Number.isInteger(pid) && Number(pid) > 0 ? ` pid=${pid}` : "";
+};
+function buildDaemonFingerprintMismatchMessage({
+  label,
+  port,
+  pid
+}) {
+  return `${label} on 127.0.0.1:${port}${formatPid(pid)} is protected by a different opendevbrowser build. Run \`${STATUS_PREFLIGHT_COMMAND}\` and continue only when \`${FINGERPRINT_CURRENT_ASSERTION}\`. Use the matching binary to stop it, restart the daemon from the current install, or isolate this run with separate OPENCODE_CONFIG_DIR, OPENCODE_CACHE_DIR, daemon port, and relay port.`;
+}
+function buildDaemonFingerprintMismatchStatusGuidance() {
+  return `Recovery: run \`${STATUS_PREFLIGHT_COMMAND}\` and proceed only when \`${FINGERPRINT_CURRENT_ASSERTION}\`; use the matching binary, restart the daemon from the current install, or isolate OPENCODE_CONFIG_DIR, OPENCODE_CACHE_DIR, daemon port, and relay port.`;
+}
+
 // src/cli/daemon.ts
 import { createServer } from "http";
 import { createHash, timingSafeEqual } from "crypto";
 import { mkdirSync, readFileSync, writeFileSync, unlinkSync, existsSync } from "fs";
 import { homedir } from "os";
-import { basename, dirname, join, resolve } from "path";
+import { basename, dirname as dirname2, join, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
 // src/cli/daemon-commands.ts
@@ -394,10 +412,15 @@ function getBoolean(value) {
 }
 
 // src/inspiredesign/capture.ts
+import { mkdir } from "fs/promises";
+import { dirname, resolve } from "path";
 var INSPIREDESIGN_CAPTURE_TIMEOUT_MS = 3e4;
 var INSPIREDESIGN_CAPTURE_MAX_CHARS = 12e3;
 var ACTIVE_SESSION_COOKIE_REUSE_UNAVAILABLE_MESSAGE = "Deep capture only honors configured provider cookie sources; active session cookies are not reused.";
 var DOM_CAPTURE_HELPER_UNAVAILABLE_MESSAGE = "DOM capture helper unavailable in this execution lane.";
+var VISUAL_CAPTURE_HELPER_UNAVAILABLE_MESSAGE = "Visual evidence screenshot helper unavailable in this execution lane.";
+var VISUAL_CAPTURE_PATH_UNAVAILABLE_MESSAGE = "Visual evidence path was not configured for screenshot capture.";
+var VISUAL_CAPTURE_EMPTY_MESSAGE = "Visual evidence screenshot did not return a file path.";
 var SNAPSHOT_CAPTURE_EMPTY_MESSAGE = "Snapshot capture returned empty content.";
 var CLONE_CAPTURE_EMPTY_MESSAGE = "Clone capture returned empty component and CSS previews.";
 var DOM_CAPTURE_EMPTY_MESSAGE = "DOM capture returned empty HTML.";
@@ -605,7 +628,55 @@ var captureDomArtifact = async (manager, sessionId, remainingTimeoutMs) => {
     };
   }
 };
-var buildCaptureEvidence = (snapshot, clone, dom) => {
+var buildVisualEvidenceMetadata = (status, detail, warnings = [], tempPath) => ({
+  status,
+  kind: "viewport",
+  fullPage: false,
+  capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+  ...tempPath ? { tempPath } : {},
+  warnings,
+  ...detail ? { failure: sanitizeInspiredesignCaptureText(detail) } : {}
+});
+var captureVisualEvidenceArtifact = async (manager, sessionId, options, remainingTimeoutMs) => {
+  const visualEvidence = options.visualEvidence ?? "off";
+  if (visualEvidence === "off") return void 0;
+  if (!options.visualEvidencePath) {
+    return buildVisualEvidenceMetadata(
+      visualEvidence === "required" ? "failed" : "skipped",
+      VISUAL_CAPTURE_PATH_UNAVAILABLE_MESSAGE
+    );
+  }
+  if (typeof manager.screenshot !== "function") {
+    return buildVisualEvidenceMetadata(
+      visualEvidence === "required" ? "failed" : "skipped",
+      VISUAL_CAPTURE_HELPER_UNAVAILABLE_MESSAGE
+    );
+  }
+  try {
+    await mkdir(dirname(options.visualEvidencePath), { recursive: true });
+    const screenshot = await withCaptureDeadline(
+      manager.screenshot(sessionId, {
+        path: options.visualEvidencePath,
+        fullPage: false
+      }),
+      remainingTimeoutMs(),
+      "visual evidence screenshot"
+    );
+    if (!screenshot.path) {
+      return buildVisualEvidenceMetadata("failed", VISUAL_CAPTURE_EMPTY_MESSAGE);
+    }
+    if (resolve(screenshot.path) !== resolve(options.visualEvidencePath)) {
+      return buildVisualEvidenceMetadata("failed", "Visual evidence screenshot path did not match the requested artifact path.");
+    }
+    return buildVisualEvidenceMetadata("captured", void 0, screenshot.warnings ?? [], options.visualEvidencePath);
+  } catch (error) {
+    return buildVisualEvidenceMetadata(
+      "failed",
+      detailFromCaptureError(error, "Visual evidence screenshot failed.")
+    );
+  }
+};
+var buildCaptureEvidence = (snapshot, clone, dom, visual) => {
   const attempts = {
     snapshot: snapshot.attempt,
     clone: clone.attempt,
@@ -615,6 +686,7 @@ var buildCaptureEvidence = (snapshot, clone, dom) => {
     ...snapshot.snapshot ? { snapshot: snapshot.snapshot } : {},
     ...dom.dom ? { dom: dom.dom } : {},
     ...clone.clone ? { clone: clone.clone } : {},
+    ...visual ? { visual } : {},
     attempts
   };
 };
@@ -630,7 +702,7 @@ var buildTransportTimeoutCaptureEvidence = (snapshot, clone, label) => {
     attempts
   };
 };
-var captureInspiredesignArtifacts = async (manager, sessionId, remainingTimeoutMs) => {
+var captureInspiredesignArtifacts = async (manager, sessionId, remainingTimeoutMs, options) => {
   const snapshot = await captureSnapshotArtifact(manager, sessionId, remainingTimeoutMs);
   if (snapshot.transportTimedOut) {
     return buildTransportTimeoutCaptureEvidence(snapshot, void 0, "snapshot capture");
@@ -640,7 +712,8 @@ var captureInspiredesignArtifacts = async (manager, sessionId, remainingTimeoutM
     return buildTransportTimeoutCaptureEvidence(snapshot, clone, "clone capture");
   }
   const dom = await captureDomArtifact(manager, sessionId, remainingTimeoutMs);
-  return buildCaptureEvidence(snapshot, clone, dom);
+  const visual = await captureVisualEvidenceArtifact(manager, sessionId, options, remainingTimeoutMs);
+  return buildCaptureEvidence(snapshot, clone, dom, visual);
 };
 async function captureInspiredesignReferenceFromManager(manager, url, options = {}) {
   const cookiePolicy = resolveInspiredesignCaptureCookiePolicy(options);
@@ -692,7 +765,7 @@ async function captureInspiredesignReferenceFromManager(manager, url, options =
         throw error;
       }
     }
-    return await captureInspiredesignArtifacts(manager, session.sessionId, remainingTimeoutMs);
+    return await captureInspiredesignArtifacts(manager, session.sessionId, remainingTimeoutMs, options);
   } finally {
     await manager.disconnect(session.sessionId, true).catch(() => void 0);
   }
@@ -1282,7 +1355,7 @@ var waitForBinding = async (clientId, timeoutMs) => {
     if (!getQueueEntry(clientId)) {
       break;
     }
-    await new Promise((resolve2) => setTimeout(resolve2, 250));
+    await new Promise((resolve3) => setTimeout(resolve3, 250));
   }
   dequeueClient(clientId);
   throw new Error("RELAY_WAIT_TIMEOUT: Timed out waiting for relay binding.");
@@ -2113,10 +2186,15 @@ async function handleDaemonCommand(core, request) {
             createDaemonWorkflowRuntime(core),
             {
               brief: requireString(params.brief, "brief"),
+              harvest: optionalBoolean2(params.harvest),
+              query: optionalString(params.query),
+              providers: optionalStringArray2(params.providers),
+              maxReferences: optionalNumber(params.maxReferences, "maxReferences"),
+              visualEvidence: optionalInspiredesignVisualEvidence(params.visualEvidence),
               urls: optionalStringArray2(params.urls),
               captureMode: optionalInspiredesignCaptureMode(params.captureMode),
               includePrototypeGuidance: optionalBoolean2(params.includePrototypeGuidance),
-              mode: optionalRenderMode(params.mode) ?? "compact",
+              mode: optionalRenderMode(params.mode),
               timeoutMs: inspiredesignTimeoutMs,
               outputDir: resolveDaemonWorkflowOutputDir(core, optionalString(params.outputDir)),
               ttlHours: optionalNumber(params.ttlHours, "ttlHours"),
@@ -2165,8 +2243,8 @@ async function handleDaemonCommand(core, request) {
                   await core.manager.goto(session.sessionId, url, "load", captureTimeoutMs);
                   const screenshot = await Promise.race([
                     core.manager.screenshot(session.sessionId),
-                    new Promise((resolve2) => {
-                      setTimeout(() => resolve2(null), captureTimeoutMs);
+                    new Promise((resolve3) => {
+                      setTimeout(() => resolve3(null), captureTimeoutMs);
                     })
                   ]);
                   if (!screenshot || typeof screenshot.base64 !== "string" || screenshot.base64.length === 0) return null;
@@ -2895,6 +2973,13 @@ function optionalInspiredesignCaptureMode(value) {
   }
   throw new Error("Invalid captureMode");
 }
+function optionalInspiredesignVisualEvidence(value) {
+  if (typeof value === "undefined") return void 0;
+  if (value === "off" || value === "auto" || value === "required") {
+    return value;
+  }
+  throw new Error("Invalid visualEvidence");
+}
 function requireWaitUntil(value) {
   if (value === "domcontentloaded" || value === "load" || value === "networkidle") {
     return value;
@@ -2968,7 +3053,7 @@ async function waitForRelayHandshake(relay, observedPort, timeoutMs) {
     if (observedStatus?.extensionHandshakeComplete) {
       return true;
     }
-    await new Promise((resolve2) => setTimeout(resolve2, delay));
+    await new Promise((resolve3) => setTimeout(resolve3, delay));
     delay = Math.min(delay * 2, WAIT_MAX_DELAY_MS);
   }
   return false;
@@ -3175,15 +3260,15 @@ function clearDaemonMetadata() {
 function resolveCurrentDaemonEntrypointPath(options = {}) {
   const rawEntry = options.argv1 ?? process.argv[1];
   if (typeof rawEntry === "string" && rawEntry.trim().length > 0) {
-    return resolve(rawEntry);
+    return resolve2(rawEntry);
   }
   const moduleUrl = options.moduleUrl ?? import.meta.url;
-  const cliEntrypoint = resolve(fileURLToPath(new URL("./index.js", moduleUrl)));
+  const cliEntrypoint = resolve2(fileURLToPath(new URL("./index.js", moduleUrl)));
   const entryExists = options.entryExists ?? existsSync;
   if (entryExists(cliEntrypoint)) {
     return cliEntrypoint;
   }
-  return resolve(fileURLToPath(moduleUrl));
+  return resolve2(fileURLToPath(moduleUrl));
 }
 function hashFileContents(entryPath) {
   try {
@@ -3193,12 +3278,12 @@ function hashFileContents(entryPath) {
   }
 }
 function resolveDaemonFingerprintDistRoot(modulePath) {
-  let currentDir = dirname(modulePath);
+  let currentDir = dirname2(modulePath);
   while (true) {
     if (basename(currentDir) === "dist") {
       return currentDir;
     }
-    const parentDir = dirname(currentDir);
+    const parentDir = dirname2(currentDir);
     if (parentDir === currentDir) {
       break;
     }
@@ -3222,7 +3307,7 @@ function readDaemonFingerprintArtifact(modulePath) {
   return null;
 }
 function getCurrentDaemonFingerprint(options = {}) {
-  const modulePath = resolve(fileURLToPath(options.moduleUrl ?? import.meta.url));
+  const modulePath = resolve2(fileURLToPath(options.moduleUrl ?? import.meta.url));
   const sharedFingerprint = readDaemonFingerprintArtifact(modulePath);
   const fingerprintParts = [
     DAEMON_FINGERPRINT_VERSION,
@@ -3360,7 +3445,11 @@ async function startDaemon(options = {}) {
         fingerprintMatches: stopFingerprint === fingerprint
       });
       if (stopFingerprint !== fingerprint) {
-        sendJson(response, 409, { ok: false, error: "Stale daemon stop request." });
+        sendJson(response, 409, {
+          ok: false,
+          error: "Stale daemon stop request.",
+          reason: DAEMON_FINGERPRINT_MISMATCH_REASON
+        });
         return;
       }
       sendJson(response, 200, { ok: true });
@@ -3383,9 +3472,9 @@ async function startDaemon(options = {}) {
     }
     sendJson(response, 404, { error: "Not found" });
   });
-  await new Promise((resolve2, reject) => {
+  await new Promise((resolve3, reject) => {
     server.once("error", reject);
-    server.listen(port, "127.0.0.1", () => resolve2());
+    server.listen(port, "127.0.0.1", () => resolve3());
   });
   const state = {
     port,
@@ -3444,8 +3533,8 @@ async function startDaemon(options = {}) {
     process.off("uncaughtException", uncaughtExceptionHandler);
     process.off("unhandledRejection", unhandledRejectionHandler);
     core.cleanup();
-    await new Promise((resolve2) => {
-      server.close(() => resolve2());
+    await new Promise((resolve3) => {
+      server.close(() => resolve3());
     });
     logDaemonStopDebug("stop.complete", { reason });
   };
@@ -3464,7 +3553,7 @@ async function startDaemon(options = {}) {
   return { state, stop };
 }
 function readJson(request) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     let data = "";
     request.setEncoding("utf8");
     request.on("data", (chunk) => {
@@ -3477,7 +3566,7 @@ function readJson(request) {
           reject(new Error("Invalid JSON body"));
           return;
         }
-        resolve2(parsed);
+        resolve3(parsed);
       } catch (error) {
         reject(error);
       }
@@ -3499,7 +3588,7 @@ var sleep = async (delayMs) => {
   if (!(Number.isFinite(delayMs) && delayMs > 0)) {
     return;
   }
-  await new Promise((resolve2) => setTimeout(resolve2, delayMs));
+  await new Promise((resolve3) => setTimeout(resolve3, delayMs));
 };
 var resolveRetryAttempts = (retryAttempts) => {
   return typeof retryAttempts === "number" && Number.isFinite(retryAttempts) && retryAttempts > 1 ? Math.floor(retryAttempts) : 1;
@@ -3636,6 +3725,9 @@ export {
   fetchWithTimeoutContext,
   readResponseTextWithTimeout,
   readResponseJsonWithTimeout,
+  DAEMON_FINGERPRINT_MISMATCH_REASON,
+  buildDaemonFingerprintMismatchMessage,
+  buildDaemonFingerprintMismatchStatusGuidance,
   DAEMON_STOP_DEBUG_ENV,
   getCacheRoot,
   readDaemonMetadata,
@@ -3648,4 +3740,4 @@ export {
   fetchDaemonStatusFromMetadata,
   persistDaemonStatusMetadata
 };
-//# sourceMappingURL=chunk-COAOWH3G.js.map
+//# sourceMappingURL=chunk-HMRANSDX.js.map