@plannotator/opencode 0.19.23 → 0.19.24

package/dist/index.js

@@ -42498,9 +42498,9 @@ var Thread = class {
         stderrChunks.push(data);
       });
     }
-    const exitPromise = new Promise((resolve5) => {
+    const exitPromise = new Promise((resolve6) => {
       child.once("exit", (code, signal) => {
-        resolve5({ code, signal });
+        resolve6({ code, signal });
       });
     });
     const rl2 = readline.createInterface({
@@ -43021,8 +43021,8 @@ class PiProcess {
   }
   sendAndWait(command) {
     const id = `req_${++this.nextId}`;
-    return new Promise((resolve5, reject) => {
-      this.pendingRequests.set(id, { resolve: resolve5, reject });
+    return new Promise((resolve6, reject) => {
+      this.pendingRequests.set(id, { resolve: resolve6, reject });
       this.send({ ...command, id });
     });
   }
@@ -43167,15 +43167,15 @@ var init_pi_sdk = __esm(() => {
         }
         const effectivePrompt = buildEffectivePrompt(prompt, this.config.systemPrompt, this._firstQuerySent);
         const queue = [];
-        let resolve5 = null;
+        let resolve6 = null;
         let done = false;
         const push = (msg) => {
           queue.push(msg);
-          resolve5?.();
+          resolve6?.();
         };
         const finish = () => {
           done = true;
-          resolve5?.();
+          resolve6?.();
         };
         const unsubscribe = this.process.onEvent((event) => {
           const mapped = mapPiEvent(event, this.id);
@@ -43207,9 +43207,9 @@ var init_pi_sdk = __esm(() => {
               yield queue.shift();
             } else {
               await new Promise((r9) => {
-                resolve5 = r9;
+                resolve6 = r9;
               });
-              resolve5 = null;
+              resolve6 = null;
             }
           }
         } finally {
@@ -43245,7 +43245,7 @@ var init_types_gen = () => {};
 // ../../node_modules/.bun/@opencode-ai+sdk@1.3.5/node_modules/@opencode-ai/sdk/dist/gen/core/serverSentEvents.gen.js
 var createSseClient = ({ onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url, ...options }) => {
   let lastEventId;
-  const sleep = sseSleepFn ?? ((ms) => new Promise((resolve5) => setTimeout(resolve5, ms)));
+  const sleep = sseSleepFn ?? ((ms) => new Promise((resolve6) => setTimeout(resolve6, ms)));
   const createStream = async function* () {
     let retryDelay = sseDefaultRetryDelay ?? 3000;
     let attempt = 0;
@@ -44646,7 +44646,7 @@ async function createOpencodeServer(options) {
       OPENCODE_CONFIG_CONTENT: JSON.stringify(options.config ?? {})
     }
   });
-  const url = await new Promise((resolve5, reject) => {
+  const url = await new Promise((resolve6, reject) => {
     const id = setTimeout(() => {
       reject(new Error(`Timeout waiting for server to start after ${options.timeout}ms`));
     }, options.timeout);
@@ -44662,7 +44662,7 @@ async function createOpencodeServer(options) {
             throw new Error(`Failed to parse server url from output: ${line}`);
           }
           clearTimeout(id);
-          resolve5(match[1]);
+          resolve6(match[1]);
           return;
         }
       }
@@ -45160,9 +45160,25 @@ var init_opencode_sdk = __esm(() => {
 // index.ts
 import { tool } from "@opencode-ai/plugin";
 import { existsSync as existsSync11, mkdirSync as mkdirSync8, readFileSync as readFileSync7, unlinkSync as unlinkSync3, writeFileSync as writeFileSync5 } from "fs";
-import { homedir as homedir9 } from "os";
 import path4 from "path";
 
+// ../../packages/shared/data-dir.ts
+import { homedir } from "os";
+import { join, resolve } from "path";
+function getPlannotatorDataDir() {
+  const envDir = process.env.PLANNOTATOR_DATA_DIR?.trim();
+  if (!envDir) {
+    return join(homedir(), ".plannotator");
+  }
+  const home = homedir();
+  if (envDir === "~")
+    return home;
+  if (envDir.startsWith("~/") || envDir.startsWith("~\\")) {
+    return join(home, envDir.slice(2));
+  }
+  return resolve(envDir);
+}
+
 // ../../packages/server/remote.ts
 var DEFAULT_REMOTE_PORT = 19432;
 var LOOPBACK_HOST = "127.0.0.1";
@@ -45235,7 +45251,7 @@ async function openEditorDiff(oldPath, newPath) {
 
 // ../../packages/server/integrations.ts
 var {$: $2 } = globalThis.Bun;
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { mkdirSync, existsSync as existsSync3, statSync } from "fs";
 
 // ../../packages/server/project.ts
@@ -45291,18 +45307,18 @@ async function detectProjectName() {
 
 // ../../packages/shared/integrations-common.ts
 import { existsSync, readFileSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 function detectObsidianVaults() {
   try {
     const home = process.env.HOME || process.env.USERPROFILE || "";
     let configPath;
     if (process.platform === "darwin") {
-      configPath = join(home, "Library/Application Support/obsidian/obsidian.json");
+      configPath = join2(home, "Library/Application Support/obsidian/obsidian.json");
     } else if (process.platform === "win32") {
-      const appData = process.env.APPDATA || join(home, "AppData/Roaming");
-      configPath = join(appData, "obsidian/obsidian.json");
+      const appData = process.env.APPDATA || join2(home, "AppData/Roaming");
+      configPath = join2(appData, "obsidian/obsidian.json");
     } else {
-      configPath = join(home, ".config/obsidian/obsidian.json");
+      configPath = join2(home, ".config/obsidian/obsidian.json");
     }
     if (!existsSync(configPath)) {
       return [];
@@ -45415,8 +45431,8 @@ Last Edited: ${now}
 }
 
 // ../../packages/shared/resolve-file.ts
-import { homedir } from "os";
-import { isAbsolute, join as join2, resolve, win32 } from "path";
+import { homedir as homedir2 } from "os";
+import { isAbsolute, join as join3, resolve as resolve2, win32 } from "path";
 import { existsSync as existsSync2, readdirSync } from "fs";
 
 // ../../packages/shared/code-file.ts
@@ -45481,12 +45497,12 @@ function normalizeSeparators(input) {
 function stripTrailingSlashes(input) {
   return input.replace(/\/+$/, "");
 }
-function expandHomePath(input, home = homedir()) {
+function expandHomePath(input, home = homedir2()) {
   if (input === "~") {
     return home;
   }
   if (input.startsWith("~/") || input.startsWith("~\\")) {
-    return join2(home, input.slice(2));
+    return join3(home, input.slice(2));
   }
   return input;
 }
@@ -45532,7 +45548,7 @@ function resolveUserPath(input, baseDir = process.cwd(), platform = process.plat
   if (!normalizedInput) {
     return "";
   }
-  return isAbsoluteNormalizedUserPath(normalizedInput, platform) ? resolveAbsolutePath(normalizedInput, platform) : resolve(baseDir, normalizedInput);
+  return isAbsoluteNormalizedUserPath(normalizedInput, platform) ? resolveAbsolutePath(normalizedInput, platform) : resolve2(baseDir, normalizedInput);
 }
 function normalizeComparablePath(input) {
   return stripTrailingSlashes(normalizeSeparators(resolveUserPath(input)));
@@ -45550,7 +45566,7 @@ function getLookupKey(input, isBareFilename) {
   return isBareFilename ? getLowercaseBasename(input) : input.toLowerCase();
 }
 function resolveAbsolutePath(input, platform = process.platform) {
-  return platform === "win32" || hasWindowsDriveLetter(input) ? win32.resolve(input) : resolve(input);
+  return platform === "win32" || hasWindowsDriveLetter(input) ? win32.resolve(input) : resolve2(input);
 }
 function isSearchableMarkdownPath(input) {
   return MARKDOWN_PATH_REGEX.test(input.trim());
@@ -45572,10 +45588,10 @@ function walkFiles(dir, root, results, ignoredDirs, fileMatcher) {
       if (ignoredDirs.some((d) => d === entry.name + "/"))
         continue;
       try {
-        walkFiles(join2(dir, entry.name), root, results, ignoredDirs, fileMatcher);
+        walkFiles(join3(dir, entry.name), root, results, ignoredDirs, fileMatcher);
       } catch {}
     } else if (entry.isFile() && fileMatcher(entry.name)) {
-      const relative = join2(dir, entry.name).slice(root.length + 1).replace(/\\/g, "/");
+      const relative = join3(dir, entry.name).slice(root.length + 1).replace(/\\/g, "/");
       results.push(relative);
     }
   }
@@ -45626,12 +45642,12 @@ async function resolveCodeFile(input, projectRoot, baseDir) {
     }
     return { kind: "not_found", input: originalInput };
   }
-  const fromRoot = resolve(projectRoot, searchInput);
+  const fromRoot = resolve2(projectRoot, searchInput);
   if (isWithinProjectRoot(fromRoot, projectRoot) && fileExists(fromRoot)) {
     return { kind: "found", path: fromRoot };
   }
   if (baseDir) {
-    const fromBase = resolve(baseDir, searchInput);
+    const fromBase = resolve2(baseDir, searchInput);
     if (fileExists(fromBase)) {
       return { kind: "found", path: fromBase };
     }
@@ -45652,10 +45668,10 @@ async function resolveCodeFile(input, projectRoot, baseDir) {
     if (isBareFilename) {
       const base = fl.split("/").pop();
       if (base === target)
-        matches.push(resolve(projectRoot, f));
+        matches.push(resolve2(projectRoot, f));
     } else {
       if (fl === target || fl.endsWith("/" + target)) {
-        matches.push(resolve(projectRoot, f));
+        matches.push(resolve2(projectRoot, f));
       }
     }
   }
@@ -45682,7 +45698,7 @@ function resolveMarkdownFileCore(input, projectRoot) {
     }
     return { kind: "not_found", input };
   }
-  const fromRoot = resolve(projectRoot, searchInput);
+  const fromRoot = resolve2(projectRoot, searchInput);
   if (isWithinProjectRoot(fromRoot, projectRoot) && fileExists(fromRoot)) {
     return { kind: "found", path: fromRoot };
   }
@@ -45693,7 +45709,7 @@ function resolveMarkdownFileCore(input, projectRoot) {
     const normalizedMatch = normalizeSeparators(match);
     const matchLookupKey = getLookupKey(normalizedMatch, isBareFilename);
     if (matchLookupKey === targetLookupKey) {
-      const full = resolve(projectRoot, normalizedMatch);
+      const full = resolve2(projectRoot, normalizedMatch);
       if (isWithinProjectRoot(full, projectRoot)) {
         matches.push(full);
       }
@@ -45747,7 +45763,7 @@ function hasMarkdownFiles(dirPath, excludedDirs = IGNORED_DIRS, extensions = /\.
       if (entry.isDirectory()) {
         if (excludedDirs.some((d) => d === entry.name + "/"))
           continue;
-        if (walk(join2(dir, entry.name)))
+        if (walk(join3(dir, entry.name)))
           return true;
       } else if (entry.isFile() && extensions.test(entry.name)) {
         return true;
@@ -45818,12 +45834,12 @@ async function saveToObsidian(config) {
       };
     }
     const folderName = folder.trim() || "plannotator";
-    const targetFolder = join3(normalizedVault, folderName);
+    const targetFolder = join4(normalizedVault, folderName);
     if (!existsSync3(targetFolder)) {
       mkdirSync(targetFolder, { recursive: true });
     }
     const filename = generateFilename(plan, config.filenameFormat, config.filenameSeparator);
-    const filePath = join3(targetFolder, filename);
+    const filePath = join4(targetFolder, filename);
     const tags = await extractTags(plan);
     const frontmatter = generateFrontmatter(tags);
     const content = `${frontmatter}
@@ -45879,15 +45895,15 @@ ${plan}`;
 }
 
 // ../../packages/shared/storage.ts
-import { homedir as homedir2 } from "os";
-import { join as join4, resolve as resolve2, sep } from "path";
+import { join as join5, resolve as resolve3, sep } from "path";
 import { mkdirSync as mkdirSync2, writeFileSync, readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2, existsSync as existsSync4 } from "fs";
+var DATA_DIR = getPlannotatorDataDir();
 function getPlanDir(customPath) {
   let planDir;
   if (customPath?.trim()) {
     planDir = resolveUserPath(customPath);
   } else {
-    planDir = join4(homedir2(), ".plannotator", "plans");
+    planDir = join5(DATA_DIR, "plans");
   }
   mkdirSync2(planDir, { recursive: true });
   return planDir;
@@ -45906,13 +45922,13 @@ function generateSlug(plan) {
 }
 function saveAnnotations(slug, annotationsContent, customPath) {
   const planDir = getPlanDir(customPath);
-  const filePath = join4(planDir, `${slug}.annotations.md`);
+  const filePath = join5(planDir, `${slug}.annotations.md`);
   writeFileSync(filePath, annotationsContent, "utf-8");
   return filePath;
 }
 function saveFinalSnapshot(slug, status, plan, annotations, customPath) {
   const planDir = getPlanDir(customPath);
-  const filePath = join4(planDir, `${slug}-${status}.md`);
+  const filePath = join5(planDir, `${slug}-${status}.md`);
   let content = plan;
   if (annotations && annotations !== "No changes detected.") {
     content += `
@@ -45956,7 +45972,7 @@ function listArchivedPlans(customPath) {
       if (!parsed)
         continue;
       try {
-        const stat = statSync2(join4(planDir, entry));
+        const stat = statSync2(join5(planDir, entry));
         parsed.size = stat.size;
         parsed.timestamp = stat.mtime.toISOString();
       } catch {}
@@ -45969,7 +45985,7 @@ function listArchivedPlans(customPath) {
 }
 function readArchivedPlan(filename, customPath) {
   const planDir = getPlanDir(customPath);
-  const filePath = resolve2(planDir, filename);
+  const filePath = resolve3(planDir, filename);
   if (!filePath.startsWith(planDir + sep))
     return null;
   try {
@@ -45979,7 +45995,7 @@ function readArchivedPlan(filename, customPath) {
   }
 }
 function getHistoryDir(project, slug) {
-  const historyDir = join4(homedir2(), ".plannotator", "history", project, slug);
+  const historyDir = join5(DATA_DIR, "history", project, slug);
   mkdirSync2(historyDir, { recursive: true });
   return historyDir;
 }
@@ -46004,7 +46020,7 @@ function saveToHistory(project, slug, plan) {
   const historyDir = getHistoryDir(project, slug);
   const nextVersion = getNextVersionNumber(historyDir);
   if (nextVersion > 1) {
-    const latestPath = join4(historyDir, `${String(nextVersion - 1).padStart(3, "0")}.md`);
+    const latestPath = join5(historyDir, `${String(nextVersion - 1).padStart(3, "0")}.md`);
     try {
       const existing = readFileSync2(latestPath, "utf-8");
       if (existing === plan) {
@@ -46013,14 +46029,14 @@ function saveToHistory(project, slug, plan) {
     } catch {}
   }
   const fileName = `${String(nextVersion).padStart(3, "0")}.md`;
-  const filePath = join4(historyDir, fileName);
+  const filePath = join5(historyDir, fileName);
   writeFileSync(filePath, plan, "utf-8");
   return { version: nextVersion, path: filePath, isNew: true };
 }
 function getPlanVersion(project, slug, version) {
-  const historyDir = join4(homedir2(), ".plannotator", "history", project, slug);
+  const historyDir = join5(DATA_DIR, "history", project, slug);
   const fileName = `${String(version).padStart(3, "0")}.md`;
-  const filePath = join4(historyDir, fileName);
+  const filePath = join5(historyDir, fileName);
   try {
     return readFileSync2(filePath, "utf-8");
   } catch {
@@ -46028,13 +46044,13 @@ function getPlanVersion(project, slug, version) {
   }
 }
 function getPlanVersionPath(project, slug, version) {
-  const historyDir = join4(homedir2(), ".plannotator", "history", project, slug);
+  const historyDir = join5(DATA_DIR, "history", project, slug);
   const fileName = `${String(version).padStart(3, "0")}.md`;
-  const filePath = join4(historyDir, fileName);
+  const filePath = join5(historyDir, fileName);
   return existsSync4(filePath) ? filePath : null;
 }
 function getVersionCount(project, slug) {
-  const historyDir = join4(homedir2(), ".plannotator", "history", project, slug);
+  const historyDir = join5(DATA_DIR, "history", project, slug);
   try {
     const entries = readdirSync2(historyDir);
     return entries.filter((e) => /^\d+\.md$/.test(e)).length;
@@ -46043,7 +46059,7 @@ function getVersionCount(project, slug) {
   }
 }
 function listVersions(project, slug) {
-  const historyDir = join4(homedir2(), ".plannotator", "history", project, slug);
+  const historyDir = join5(DATA_DIR, "history", project, slug);
   try {
     const entries = readdirSync2(historyDir);
     const versions = [];
@@ -46051,7 +46067,7 @@ function listVersions(project, slug) {
       const match = entry.match(/^(\d+)\.md$/);
       if (match) {
         const version = parseInt(match[1], 10);
-        const filePath = join4(historyDir, entry);
+        const filePath = join5(historyDir, entry);
         try {
           const stat = statSync2(filePath);
           versions.push({ version, timestamp: stat.mtime.toISOString() });
@@ -46154,8 +46170,7 @@ async function getRepoInfo() {
 }
 
 // ../../packages/shared/config.ts
-import { homedir as homedir3 } from "os";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, existsSync as existsSync5 } from "fs";
 import { execSync } from "child_process";
 var PROMPT_SECTIONS = ["review", "plan", "annotate"];
@@ -46176,8 +46191,8 @@ function mergePromptConfig(current, partial) {
   }
   return result;
 }
-var CONFIG_DIR = join5(homedir3(), ".plannotator");
-var CONFIG_PATH = join5(CONFIG_DIR, "config.json");
+var CONFIG_DIR = getPlannotatorDataDir();
+var CONFIG_PATH = join6(CONFIG_DIR, "config.json");
 function loadConfig() {
   try {
     if (!existsSync5(CONFIG_PATH))
@@ -46246,11 +46261,11 @@ function resolveUseJina(cliNoJina, config) {
   return true;
 }
 // ../../packages/shared/improvement-hooks.ts
-import { homedir as homedir4 } from "os";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { readFileSync as readFileSync4, statSync as statSync3 } from "fs";
-var HOOKS_BASE_DIR = join6(homedir4(), ".plannotator", "hooks");
-var LEGACY_BASE_DIR = join6(homedir4(), ".plannotator");
+var DATA_DIR2 = getPlannotatorDataDir();
+var HOOKS_BASE_DIR = join7(DATA_DIR2, "hooks");
+var LEGACY_BASE_DIR = DATA_DIR2;
 var MAX_FILE_SIZE = 50 * 1024;
 var KNOWN_HOOKS = {
   "enterplanmode-improve": {
@@ -46262,7 +46277,7 @@ function getImprovementHookExpectedPath(hookName) {
   const entry = KNOWN_HOOKS[hookName];
   if (!entry)
     return null;
-  return join6(HOOKS_BASE_DIR, entry.path);
+  return join7(HOOKS_BASE_DIR, entry.path);
 }
 function fileExists2(path) {
   try {
@@ -46289,11 +46304,11 @@ function readImprovementHook(hookName) {
   const entry = KNOWN_HOOKS[hookName];
   if (!entry)
     return null;
-  const newPath = join6(HOOKS_BASE_DIR, entry.path);
+  const newPath = join7(HOOKS_BASE_DIR, entry.path);
   if (fileExists2(newPath)) {
     return tryReadHookFile(newPath, hookName);
   }
-  const legacyFilePath = join6(LEGACY_BASE_DIR, entry.legacyPath);
+  const legacyFilePath = join7(LEGACY_BASE_DIR, entry.legacyPath);
   return tryReadHookFile(legacyFilePath, hookName);
 }
 
@@ -46362,14 +46377,15 @@ Other extras
 Plain prose is always fine. The point is: prefer code-file links over copy-pasted snippets, and reach for callouts or tables when structure makes the plan easier to scan.`;
 
 // ../../packages/server/shared-handlers.ts
-import { mkdirSync as mkdirSync5 } from "fs";
+import { appendFileSync, mkdirSync as mkdirSync5 } from "fs";
+import { dirname } from "path";
 
 // ../../packages/server/browser.ts
 var {$: $4 } = globalThis.Bun;
 import os from "os";
 import path from "path";
 import fs from "fs";
-var IPC_REGISTRY = path.join(os.homedir(), ".plannotator", "vscode-ipc.json");
+var IPC_REGISTRY = path.join(getPlannotatorDataDir(), "vscode-ipc.json");
 var NOOP_BROWSER_VALUES = new Set(["true", "false", "none", ":", "0", "1"]);
 function isNoOpBrowserSentinel(value) {
   if (!value)
@@ -46465,7 +46481,7 @@ async function openBrowser(url, options) {
 }
 
 // ../../packages/server/image.ts
-import { resolve as resolve3, join as join7 } from "path";
+import { resolve as resolve4, join as join8 } from "path";
 import { tmpdir } from "os";
 var ALLOWED_IMAGE_EXTENSIONS = new Set([
   "png",
@@ -46480,7 +46496,7 @@ var ALLOWED_IMAGE_EXTENSIONS = new Set([
   "tif",
   "avif"
 ]);
-var UPLOAD_DIR = join7(tmpdir(), "plannotator");
+var UPLOAD_DIR = join8(tmpdir(), "plannotator");
 function getExtension(filePath) {
   const lastDot = filePath.lastIndexOf(".");
   if (lastDot === -1)
@@ -46491,7 +46507,7 @@ function hasImageExtension(filePath) {
   return ALLOWED_IMAGE_EXTENSIONS.has(getExtension(filePath));
 }
 function validateImagePath(rawPath) {
-  const resolved = resolve3(rawPath);
+  const resolved = resolve4(rawPath);
   if (!hasImageExtension(resolved)) {
     return {
       valid: false,
@@ -46514,12 +46530,11 @@ function validateUploadExtension(fileName) {
 }
 
 // ../../packages/shared/draft.ts
-import { homedir as homedir5 } from "os";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync3, readFileSync as readFileSync5, unlinkSync, existsSync as existsSync6 } from "fs";
 import { createHash } from "crypto";
 function getDraftDir() {
-  const dir = join8(homedir5(), ".plannotator", "drafts");
+  const dir = join9(getPlannotatorDataDir(), "drafts");
   mkdirSync4(dir, { recursive: true });
   return dir;
 }
@@ -46528,10 +46543,10 @@ function contentHash(content) {
 }
 function saveDraft(key, data) {
   const dir = getDraftDir();
-  writeFileSync3(join8(dir, `${key}.json`), JSON.stringify(data), "utf-8");
+  writeFileSync3(join9(dir, `${key}.json`), JSON.stringify(data), "utf-8");
 }
 function loadDraft(key) {
-  const filePath = join8(getDraftDir(), `${key}.json`);
+  const filePath = join9(getDraftDir(), `${key}.json`);
   try {
     if (!existsSync6(filePath))
       return null;
@@ -46541,7 +46556,7 @@ function loadDraft(key) {
   }
 }
 function deleteDraft(key) {
-  const filePath = join8(getDraftDir(), `${key}.json`);
+  const filePath = join9(getDraftDir(), `${key}.json`);
   try {
     if (existsSync6(filePath))
       unlinkSync(filePath);
@@ -46646,13 +46661,30 @@ function handleFavicon() {
     headers: { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=86400" }
   });
 }
-async function handleServerReady(url, isRemote, _port) {
-  await openBrowser(url, { isRemote });
+function writeServerReadyMetadata(readyFile, metadata) {
+  mkdirSync5(dirname(readyFile), { recursive: true });
+  appendFileSync(readyFile, `${JSON.stringify(metadata)}
+`, "utf8");
+}
+async function handleServerReady(url, isRemote, port, options = {}) {
+  const readyFile = options.readyFile ?? process.env.PLANNOTATOR_READY_FILE;
+  if (readyFile) {
+    try {
+      writeServerReadyMetadata(readyFile, { url, isRemote, port });
+    } catch (error) {
+      if (options.readyFile)
+        throw error;
+    }
+  }
+  const skipBrowserOpen = options.skipBrowserOpen ?? process.env.PLANNOTATOR_SKIP_BROWSER_OPEN === "1";
+  if (skipBrowserOpen)
+    return;
+  await (options.openBrowser ?? openBrowser)(url, { isRemote });
 }
 
 // ../../packages/server/reference-handlers.ts
 import { existsSync as existsSync7, statSync as statSync4 } from "fs";
-import { resolve as resolve4 } from "path";
+import { resolve as resolve5 } from "path";
 
 // ../../packages/shared/reference-common.ts
 var FILE_BROWSER_EXCLUDED = [
@@ -47359,14 +47391,14 @@ function process2(parentNode) {
     } else if (node.nodeType === 1) {
       replacement = replacementForNode.call(self2, node);
     }
-    return join9(output, replacement);
+    return join10(output, replacement);
   }, "");
 }
 function postProcess(output) {
   var self2 = this;
   this.rules.forEach(function(rule) {
     if (typeof rule.append === "function") {
-      output = join9(output, rule.append(self2.options));
+      output = join10(output, rule.append(self2.options));
     }
   });
   return output.replace(/^[\t\r\n]+/, "").replace(/[\t\r\n\s]+$/, "");
@@ -47379,7 +47411,7 @@ function replacementForNode(node) {
     content = content.trim();
   return whitespace.leading + rule.replacement(content, node, this.options) + whitespace.trailing;
 }
-function join9(output, replacement) {
+function join10(output, replacement) {
   var s1 = trimTrailingNewlines(output);
   var s2 = trimLeadingNewlines(replacement);
   var nls = Math.max(output.length - s1.length, replacement.length - s2.length);
@@ -61294,7 +61326,7 @@ async function handleObsidianDoc(req) {
     return Response.json({ error: "Only markdown files are supported" }, { status: 400 });
   }
   const resolvedVault = resolveUserPath(vaultPath);
-  let resolvedFile = resolve4(resolvedVault, filePath);
+  let resolvedFile = resolve5(resolvedVault, filePath);
   if (!existsSync7(resolvedFile) && !filePath.includes("/")) {
     const glob = new Bun.Glob(`**/${filePath}`);
     const matches2 = [];
@@ -61304,7 +61336,7 @@ async function handleObsidianDoc(req) {
     })) {
       if (match.includes(".obsidian/") || match.includes(".trash/"))
         continue;
-      matches2.push(resolve4(resolvedVault, match));
+      matches2.push(resolve5(resolvedVault, match));
     }
     if (matches2.length === 1) {
       resolvedFile = matches2[0];
@@ -62112,8 +62144,8 @@ async function startPlannotatorServer(options) {
   if (mode === "archive") {
     archivePlans = listArchivedPlans(customPlanPath ?? undefined);
     initialArchivePlan = archivePlans.length > 0 ? readArchivedPlan(archivePlans[0].filename, customPlanPath ?? undefined) ?? "" : "";
-    donePromise = new Promise((resolve5) => {
-      resolveDone = resolve5;
+    donePromise = new Promise((resolve6) => {
+      resolveDone = resolve6;
     });
   }
   const draftKey = mode !== "archive" ? contentHash(plan) : "";
@@ -62140,8 +62172,8 @@ async function startPlannotatorServer(options) {
       totalVersions: getVersionCount(project, slug),
       project
     };
-    decisionPromise = new Promise((resolve5) => {
-      resolveDecision = resolve5;
+    decisionPromise = new Promise((resolve6) => {
+      resolveDecision = resolve6;
     });
   } else {
     decisionPromise = new Promise(() => {});
@@ -62977,7 +63009,7 @@ function parseP4DiffType(diffType) {
 }
 
 // ../../packages/shared/vcs-core.ts
-import { isAbsolute as isAbsolute2, relative, resolve as resolve5 } from "path";
+import { isAbsolute as isAbsolute2, relative, resolve as resolve6 } from "path";
 
 // ../../packages/shared/jj-core.ts
 import { basename as basename2 } from "path";
@@ -63305,7 +63337,7 @@ var JJ_DIFF_TYPES = new Set(["jj-current", "jj-last", "jj-line", "jj-evolog", "j
 function selectNearestProvider(candidates, cwd) {
   if (candidates.length === 0)
     return null;
-  const effectiveCwd = resolve5(cwd ?? process.cwd());
+  const effectiveCwd = resolve6(cwd ?? process.cwd());
   const ranked = candidates.map((candidate) => ({
     ...candidate,
     rootDepth: candidate.root ? vcsRootDepth(candidate.root) : -1,
@@ -63320,11 +63352,11 @@ function selectNearestProvider(candidates, cwd) {
   return ranked[0]?.provider ?? null;
 }
 function isSameOrAncestor(root3, child) {
-  const relativePath = relative(resolve5(root3), child);
+  const relativePath = relative(resolve6(root3), child);
   return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute2(relativePath);
 }
 function vcsRootDepth(root3) {
-  return resolve5(root3).split(/[\\/]+/).filter(Boolean).length;
+  return resolve6(root3).split(/[\\/]+/).filter(Boolean).length;
 }
 function createGitProvider(runtime) {
   return {
@@ -64719,17 +64751,18 @@ function createAgentJobHandler(options) {
 }
 
 // ../../packages/server/codex-review.ts
-import { join as join10 } from "path";
-import { homedir as homedir6, tmpdir as tmpdir2 } from "os";
+import { join as join11 } from "path";
+import { tmpdir as tmpdir2 } from "os";
 import { appendFile, mkdir, unlink, writeFile, readFile } from "fs/promises";
 import { existsSync as existsSync10 } from "fs";
+var DATA_DIR3 = getPlannotatorDataDir();
 var DEBUG_ENABLED = !!process.env.PLANNOTATOR_DEBUG;
-var DEBUG_LOG_PATH = join10(homedir6(), ".plannotator", "codex-review-debug.log");
+var DEBUG_LOG_PATH = join11(DATA_DIR3, "codex-review-debug.log");
 async function debugLog(label, data) {
   if (!DEBUG_ENABLED)
     return;
   try {
-    await mkdir(join10(homedir6(), ".plannotator"), { recursive: true });
+    await mkdir(DATA_DIR3, { recursive: true });
     const timestamp = new Date().toISOString();
     const line = data !== undefined ? `[${timestamp}] ${label}: ${typeof data === "string" ? data : JSON.stringify(data, null, 2)}
 ` : `[${timestamp}] ${label}
@@ -64778,8 +64811,8 @@ var CODEX_REVIEW_SCHEMA = JSON.stringify({
   required: ["findings", "overall_correctness", "overall_explanation", "overall_confidence_score"],
   additionalProperties: false
 });
-var SCHEMA_DIR = join10(homedir6(), ".plannotator");
-var SCHEMA_FILE = join10(SCHEMA_DIR, "codex-review-schema.json");
+var SCHEMA_DIR = DATA_DIR3;
+var SCHEMA_FILE = join11(SCHEMA_DIR, "codex-review-schema.json");
 var schemaMaterialized = false;
 async function ensureSchemaFile() {
   if (!schemaMaterialized) {
@@ -64875,7 +64908,7 @@ async function buildCodexCommand(options) {
   return command;
 }
 function generateOutputPath() {
-  return join10(tmpdir2(), `plannotator-codex-${crypto.randomUUID()}.json`);
+  return join11(tmpdir2(), `plannotator-codex-${crypto.randomUUID()}.json`);
 }
 async function parseCodexOutput(outputPath) {
   await debugLog("PARSE_OUTPUT_START", { outputPath });
@@ -65064,8 +65097,8 @@ function shellQuote(value) {
 }
 
 // ../../packages/server/tour/tour-review.ts
-import { join as join11 } from "path";
-import { homedir as homedir7, tmpdir as tmpdir3 } from "os";
+import { join as join12 } from "path";
+import { tmpdir as tmpdir3 } from "os";
 import { mkdir as mkdir2, writeFile as writeFile2, readFile as readFile2, unlink as unlink2 } from "fs/promises";
 var TOUR_EMPTY_OUTPUT_ERROR = "Tour generation returned empty or malformed output";
 var TOUR_SCHEMA_JSON = JSON.stringify({
@@ -65459,8 +65492,8 @@ function buildTourClaudeCommand(prompt, model = "sonnet", effort) {
     stdinPrompt: prompt
   };
 }
-var TOUR_SCHEMA_DIR = join11(homedir7(), ".plannotator");
-var TOUR_SCHEMA_FILE = join11(TOUR_SCHEMA_DIR, "tour-schema.json");
+var TOUR_SCHEMA_DIR = getPlannotatorDataDir();
+var TOUR_SCHEMA_FILE = join12(TOUR_SCHEMA_DIR, "tour-schema.json");
 var tourSchemaMaterialized = false;
 async function ensureTourSchemaFile() {
   if (!tourSchemaMaterialized) {
@@ -65471,7 +65504,7 @@ async function ensureTourSchemaFile() {
   return TOUR_SCHEMA_FILE;
 }
 function generateTourOutputPath() {
-  return join11(tmpdir3(), `plannotator-tour-${crypto.randomUUID()}.json`);
+  return join12(tmpdir3(), `plannotator-tour-${crypto.randomUUID()}.json`);
 }
 async function buildTourCodexCommand(options) {
   const { cwd, outputPath, prompt, model, reasoningEffort, fastMode } = options;
@@ -66144,8 +66177,7 @@ async function fetchGhPRList(runtime3, ref) {
 }
 
 // ../../packages/shared/pr-gitlab.ts
-import { homedir as homedir8 } from "os";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync4 } from "fs";
 function encodeProject(projectPath) {
   return encodeURIComponent(projectPath);
@@ -66527,10 +66559,10 @@ async function submitGlMRReview(runtime3, ref, headSha, action, body3, fileComme
       const failed = results.map((r9, i4) => r9.status === "rejected" ? fileComments[i4] : null).filter((c3) => c3 !== null);
       let savedTo = null;
       try {
-        const dir = join12(homedir8(), ".plannotator", "failed-comments");
+        const dir = join13(getPlannotatorDataDir(), "failed-comments");
         mkdirSync7(dir, { recursive: true });
         const slug = `${ref.host}-${ref.projectPath.replace(/\//g, "_")}-mr${ref.iid}-${Date.now()}`;
-        savedTo = join12(dir, `${slug}.json`);
+        savedTo = join13(dir, `${slug}.json`);
         writeFileSync4(savedTo, JSON.stringify({ ref, headSha, baseSha, startSha, errors, failedComments: failed }, null, 2));
       } catch (writeErr) {
         console.error(`[plannotator] Failed to persist unposted comments: ${writeErr instanceof Error ? writeErr.message : String(writeErr)}`);
@@ -67183,8 +67215,8 @@ async function startReviewServer(options) {
     } catch {}
   }
   let resolveDecision;
-  const decisionPromise = new Promise((resolve6) => {
-    resolveDecision = resolve6;
+  const decisionPromise = new Promise((resolve7) => {
+    resolveDecision = resolve7;
   });
   let server2 = null;
   for (let attempt = 1;attempt <= MAX_RETRIES2; attempt++) {
@@ -67722,7 +67754,7 @@ async function startReviewServer(options) {
 }
 
 // ../../packages/server/annotate.ts
-import { dirname, resolve as resolvePath2 } from "path";
+import { dirname as dirname2, resolve as resolvePath2 } from "path";
 var MAX_RETRIES3 = 5;
 var RETRY_DELAY_MS3 = 500;
 async function startAnnotateServer(options) {
@@ -67754,8 +67786,8 @@ async function startAnnotateServer(options) {
   const aiRuntime = await createAIRuntime();
   const repoInfo = await getRepoInfo();
   let resolveDecision;
-  const decisionPromise = new Promise((resolve6) => {
-    resolveDecision = resolve6;
+  const decisionPromise = new Promise((resolve7) => {
+    resolveDecision = resolve7;
   });
   let server2 = null;
   for (let attempt = 1;attempt <= MAX_RETRIES3; attempt++) {
@@ -67810,7 +67842,7 @@ async function startAnnotateServer(options) {
           if (url.pathname === "/api/doc" && req.method === "GET") {
             if (!url.searchParams.has("base") && !/^https?:\/\//i.test(filePath)) {
               const docUrl = new URL(req.url);
-              docUrl.searchParams.set("base", dirname(filePath));
+              docUrl.searchParams.set("base", dirname2(filePath));
               return handleDoc(new Request(docUrl.toString()));
             }
             return handleDoc(req);
@@ -67933,6 +67965,7 @@ function resolveTemplate(template, vars) {
 }
 var PLAN_TOOL_NAMES = {
   "claude-code": "ExitPlanMode",
+  amp: "ExitPlanMode",
   droid: "ExitPlanMode",
   opencode: "submit_plan",
   "copilot-cli": "exit_plan_mode",
@@ -68957,7 +68990,7 @@ function getReviewHtml() {
 var DEFAULT_PLAN_TIMEOUT_SECONDS = 345600;
 var MAX_PLAN_SIZE = 5 * 1024 * 1024;
 function getPlanBackingPath(project) {
-  return path4.join(homedir9(), ".plannotator", "active", project, "_active-plan.md");
+  return path4.join(getPlannotatorDataDir(), "active", project, "_active-plan.md");
 }
 function applyEdits(existingLines, edits) {
   const sorted = [...edits].sort((a3, b3) => a3.start - b3.start);
@@ -69322,14 +69355,14 @@ Use /plannotator-last or /plannotator-annotate for manual review, or set workflo
           });
           const timeoutSeconds = getPlanTimeoutSeconds();
           const timeoutMs = timeoutSeconds === null ? null : timeoutSeconds * 1000;
-          const result = timeoutMs === null ? await server2.waitForDecision() : await new Promise((resolve6) => {
-            const timeoutId = setTimeout(() => resolve6({
+          const result = timeoutMs === null ? await server2.waitForDecision() : await new Promise((resolve7) => {
+            const timeoutId = setTimeout(() => resolve7({
               approved: false,
               feedback: `[Plannotator] No response within ${timeoutSeconds} seconds. Port released automatically. Please call submit_plan again.`
             }), timeoutMs);
             server2.waitForDecision().then((r9) => {
               clearTimeout(timeoutId);
-              resolve6(r9);
+              resolve7(r9);
             });
           });
           await Bun.sleep(1500);