oh-my-opencode 4.12.0 → 4.12.1

package/dist/index.js

@@ -5798,6 +5798,201 @@ function buildCodegraphEnv(options = {}) {
 var CODEGRAPH_INSTALL_DIR_ENV = "CODEGRAPH_INSTALL_DIR", CODEGRAPH_NO_DOWNLOAD_ENV = "CODEGRAPH_NO_DOWNLOAD", CODEGRAPH_TELEMETRY_ENV = "CODEGRAPH_TELEMETRY", DO_NOT_TRACK_ENV = "DO_NOT_TRACK";
 var init_env = () => {};
 
+// packages/utils/src/codegraph/workspace.ts
+import { createHash as createHash2 } from "crypto";
+import {
+  appendFileSync as appendFileSync2,
+  existsSync as existsSync5,
+  lstatSync as lstatSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  readdirSync,
+  realpathSync as realpathSync3,
+  rmSync,
+  statSync as statSync3,
+  symlinkSync
+} from "fs";
+import { homedir as homedir3 } from "os";
+import { basename as basename3, join as join9, resolve as resolve4 } from "path";
+function sanitizeBase(value) {
+  const sanitized = value.replace(/[^A-Za-z0-9._-]/g, "-").replace(/-+/g, "-");
+  return sanitized.length > 0 ? sanitized : "workspace";
+}
+function codegraphDataRoot(homeDir) {
+  return join9(homeDir, ".omo", "codegraph");
+}
+function workspaceStorageName(workspace) {
+  const resolved = resolve4(workspace);
+  const hash = createHash2("sha256").update(resolved).digest("hex").slice(0, 16);
+  return `${sanitizeBase(basename3(resolved))}-${hash}`;
+}
+function resolveCodegraphWorkspacePaths(workspace, options = {}) {
+  const resolvedWorkspace = resolve4(workspace);
+  const dataRoot = codegraphDataRoot(options.homeDir ?? homedir3());
+  return {
+    dataDir: join9(dataRoot, "projects", workspaceStorageName(resolvedWorkspace)),
+    dataRoot,
+    projectLink: join9(resolvedWorkspace, ".codegraph")
+  };
+}
+function fallbackResult(dataRoot, projectLink, reason) {
+  return { dataDir: projectLink, dataRoot, linked: false, mode: "in-place-fallback", projectLink, reason };
+}
+function isSameFilesystem(workspace, dataRoot, override) {
+  if (override !== undefined)
+    return override;
+  return statSync3(workspace).dev === statSync3(dataRoot).dev;
+}
+function ensureInPlaceFallback(projectLink) {
+  if (!existsSync5(projectLink))
+    mkdirSync2(projectLink, { recursive: true });
+}
+function prepareCodegraphWorkspace(workspace, options = {}) {
+  const resolvedWorkspace = resolve4(workspace);
+  const { dataDir, dataRoot, projectLink } = resolveCodegraphWorkspacePaths(resolvedWorkspace, options);
+  try {
+    mkdirSync2(dataDir, { recursive: true });
+    if (existsSync5(projectLink)) {
+      const linkStat = lstatSync2(projectLink);
+      if (!linkStat.isSymbolicLink()) {
+        return { dataDir: projectLink, dataRoot, linked: false, mode: "in-project", projectLink };
+      }
+      if (realpathSync3(projectLink) === realpathSync3(dataDir)) {
+        return { dataDir, dataRoot, linked: true, mode: "global-linked", projectLink };
+      }
+      return fallbackResult(dataRoot, projectLink, "existing .codegraph symlink points outside OMO store");
+    }
+    if (!isSameFilesystem(resolvedWorkspace, dataRoot, options.sameFilesystem)) {
+      ensureInPlaceFallback(projectLink);
+      return fallbackResult(dataRoot, projectLink, "workspace and OMO store are on different filesystems");
+    }
+    const symlink = options.symlink ?? symlinkSync;
+    symlink(dataDir, projectLink, (options.platform ?? process.platform) === "win32" ? "junction" : "dir");
+    return { dataDir, dataRoot, linked: true, mode: "global-linked", projectLink };
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    try {
+      ensureInPlaceFallback(projectLink);
+    } catch (fallbackError) {
+      return fallbackResult(dataRoot, projectLink, `${reason}; fallback failed: ${String(fallbackError)}`);
+    }
+    return fallbackResult(dataRoot, projectLink, reason);
+  }
+}
+function ensureCodegraphGitignored(workspace) {
+  const gitDir = join9(workspace, ".git");
+  if (!existsSync5(gitDir))
+    return false;
+  const excludePath = join9(gitDir, "info", "exclude");
+  try {
+    mkdirSync2(join9(gitDir, "info"), { recursive: true });
+    const existing = existsSync5(excludePath) ? readFileSync2(excludePath, "utf8") : "";
+    if (existing.split(/\r?\n/).includes(".codegraph"))
+      return true;
+    appendFileSync2(excludePath, `${existing.endsWith(`
+`) || existing.length === 0 ? "" : `
+`}.codegraph
+`);
+    return true;
+  } catch (error) {
+    if (error instanceof Error)
+      return false;
+    throw error;
+  }
+}
+var init_workspace = () => {};
+
+// packages/utils/src/codegraph/guidance.ts
+import { homedir as homedir4 } from "os";
+function getCodegraphUninitializedProject(input) {
+  const output = textFromUnknown(input.toolOutput);
+  if (!isCodegraphTool(input.toolName))
+    return null;
+  const projectPath = extractProjectPath(output);
+  if (projectPath !== null)
+    return projectPath;
+  if (!looksLikeCodegraphUninitializedOutput(output))
+    return null;
+  return typeof input.cwd === "string" && input.cwd.trim().length > 0 ? input.cwd.trim() : null;
+}
+function buildCodegraphInitGuidance(projectPath, options = {}) {
+  const { dataDir, dataRoot, projectLink } = resolveCodegraphWorkspacePaths(projectPath, {
+    homeDir: options.homeDir ?? homedir4()
+  });
+  const displayProjectPath = formatDisplayPath(projectPath);
+  const displayProjectLink = formatDisplayPath(projectLink);
+  const displayDataDir = formatDisplayPath(dataDir);
+  const displayDataRoot = formatDisplayPath(dataRoot);
+  return [
+    "OMO CodeGraph initialization guidance:",
+    "",
+    `CodeGraph is not initialized for ${displayProjectPath}. Initialize it through OMO's global local store instead of leaving a standalone project-local index.`,
+    "",
+    `- Link or create ${displayProjectLink} so it points at ${displayDataDir} under the OMO store ${displayDataRoot}.`,
+    `- Then run \`codegraph init\` from ${displayProjectPath} and retry the CodeGraph tool.`,
+    "- OMO's CodeGraph bootstrap does this automatically on session start; if bootstrap just ran, wait for it to finish and retry."
+  ].join(`
+`);
+}
+function buildCodegraphInitGuidanceForToolResult(input, options = {}) {
+  const projectPath = getCodegraphUninitializedProject(input);
+  return projectPath === null ? null : buildCodegraphInitGuidance(projectPath, options);
+}
+function extractProjectPath(output) {
+  const normalizedOutput = normalizeCodegraphOutput(output);
+  const uninitializedMatch = normalizedOutput.match(CODEGRAPH_UNINITIALIZED_PATTERN);
+  const uninitializedProject = uninitializedMatch?.[1]?.trim();
+  if (uninitializedProject && uninitializedProject.length > 0)
+    return uninitializedProject;
+  if (!looksLikeCodegraphUninitializedOutput(normalizedOutput))
+    return null;
+  const statusMatch = normalizedOutput.match(CODEGRAPH_STATUS_PROJECT_PATTERN);
+  const statusProject = statusMatch?.[1]?.trim();
+  return statusProject && statusProject.length > 0 ? statusProject : null;
+}
+function looksLikeCodegraphUninitializedOutput(output) {
+  const normalizedOutput = normalizeCodegraphOutput(output);
+  if (normalizedOutput.match(CODEGRAPH_UNINITIALIZED_PATTERN) !== null)
+    return true;
+  return CODEGRAPH_STATUS_UNINITIALIZED_PATTERN.test(normalizedOutput) && CODEGRAPH_INIT_HINT_PATTERN.test(normalizedOutput);
+}
+function normalizeCodegraphOutput(output) {
+  return output.replace(ANSI_ESCAPE_PATTERN, "");
+}
+function isCodegraphTool(toolName) {
+  if (typeof toolName !== "string")
+    return false;
+  return toolName.startsWith("codegraph.") || toolName.startsWith("codegraph_") || toolName.startsWith("mcp__codegraph__");
+}
+function formatDisplayPath(value) {
+  return JSON.stringify(value);
+}
+function textFromUnknown(value) {
+  if (typeof value === "string")
+    return value;
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
+    return String(value);
+  if (Array.isArray(value))
+    return value.map(textFromUnknown).filter(Boolean).join(`
+`);
+  if (!isRecord2(value))
+    return "";
+  return Object.entries(value).map(([key, nested]) => `${key}: ${textFromUnknown(nested)}`).filter((line) => line.trim().length > 0).join(`
+`);
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var CODEGRAPH_UNINITIALIZED_PATTERN, ANSI_ESCAPE_PATTERN, CODEGRAPH_STATUS_PROJECT_PATTERN, CODEGRAPH_STATUS_UNINITIALIZED_PATTERN, CODEGRAPH_INIT_HINT_PATTERN;
+var init_guidance = __esm(() => {
+  init_workspace();
+  CODEGRAPH_UNINITIALIZED_PATTERN = /CodeGraph not initialized in ([\s\S]*?)\.\s*Run ['`]codegraph init['`] in that project first\./i;
+  ANSI_ESCAPE_PATTERN = /\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+  CODEGRAPH_STATUS_PROJECT_PATTERN = /^.*?\bProject:\s*(.+?)\s*$/im;
+  CODEGRAPH_STATUS_UNINITIALIZED_PATTERN = /^.*?\bNot initialized\s*$/im;
+  CODEGRAPH_INIT_HINT_PATTERN = /Run\s+["'`]codegraph init["'`]\s+(?:in that project first|to initialize)\.?/i;
+});
+
 // packages/utils/src/codegraph/node-support.ts
 function evaluateCodegraphNodeSupport(options = {}) {
   const nodeVersion = options.nodeVersion ?? process.versions.node;
@@ -5860,24 +6055,24 @@ var init_manifest = __esm(() => {
 });
 
 // packages/utils/src/codegraph/provision.ts
-import { createHash as createHash2, randomUUID as randomUUID2 } from "crypto";
+import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
 import { execFile } from "child_process";
 import { chmod as chmod2, mkdir as mkdir2, readdir, readFile as readFile2, rename as rename2, rm as rm2, rmdir, stat, writeFile as writeFile3 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
-import { homedir as homedir3, hostname } from "os";
-import { basename as basename3, join as join9 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { homedir as homedir5, hostname } from "os";
+import { basename as basename4, join as join10 } from "path";
 import { promisify } from "util";
 function platformKey() {
   return `${process.platform}-${process.arch}`;
 }
 function markerPath(installDir, version) {
-  return join9(installDir, ".provisioned", `codegraph-${version}.json`);
+  return join10(installDir, ".provisioned", `codegraph-${version}.json`);
 }
 function defaultInstallDir() {
-  return join9(homedir3(), ".omo", "codegraph");
+  return join10(homedir5(), ".omo", "codegraph");
 }
 function sha2562(bytes) {
-  return createHash2("sha256").update(bytes).digest("hex");
+  return createHash3("sha256").update(bytes).digest("hex");
 }
 function isErrnoException(error) {
   return error instanceof Error && "code" in error;
@@ -5894,7 +6089,7 @@ async function removeEmptyDirectory(path4) {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 async function defaultDownloader(asset, timeoutMs = DEFAULT_DOWNLOAD_TIMEOUT_MS2) {
   const response = await fetch(asset.url, { signal: AbortSignal.timeout(timeoutMs) });
@@ -5908,7 +6103,7 @@ function forcedBadChecksumOptions(options) {
   const key = options.platformKey ?? platformKey();
   return {
     downloader: async () => new TextEncoder().encode("checksum mismatch"),
-    installDir: options.installDir ?? join9(options.lockDir, "codegraph-force-bad-checksum"),
+    installDir: options.installDir ?? join10(options.lockDir, "codegraph-force-bad-checksum"),
     manifest: {
       assets: {
         [key]: { executableName: process.platform === "win32" ? "codegraph.cmd" : "codegraph", sha256: "0000", url: "memory://bad" }
@@ -5919,13 +6114,13 @@ function forcedBadChecksumOptions(options) {
   };
 }
 async function readMarker(path4) {
-  if (!existsSync5(path4))
+  if (!existsSync6(path4))
     return null;
   try {
     const raw = JSON.parse(await readFile2(path4, "utf8"));
     if (typeof raw === "object" && raw !== null && "binPath" in raw) {
       const value = raw.binPath;
-      return typeof value === "string" && existsSync5(value) ? value : null;
+      return typeof value === "string" && existsSync6(value) ? value : null;
     }
     return null;
   } catch (error) {
@@ -5936,7 +6131,7 @@ async function readMarker(path4) {
 }
 async function acquireLock(lockPath, waitMs, staleMs) {
   const startedAt = Date.now();
-  await mkdir2(join9(lockPath, ".."), { recursive: true });
+  await mkdir2(join10(lockPath, ".."), { recursive: true });
   while (Date.now() - startedAt <= waitMs) {
     try {
       await mkdir2(lockPath);
@@ -5961,44 +6156,44 @@ async function installExtractedBundle(extractDir, installDir, executableName) {
   const roots = await readdir(extractDir);
   if (roots.length !== 1)
     throw new Error(`CodeGraph archive should contain one root directory, found ${roots.length}`);
-  const bundleDir = join9(extractDir, roots[0] ?? "");
+  const bundleDir = join10(extractDir, roots[0] ?? "");
   const bundleEntries = await readdir(bundleDir);
   await mkdir2(installDir, { recursive: true });
   for (const entry of bundleEntries) {
-    await rm2(join9(installDir, entry), { force: true, recursive: true });
-    await rename2(join9(bundleDir, entry), join9(installDir, entry));
+    await rm2(join10(installDir, entry), { force: true, recursive: true });
+    await rename2(join10(bundleDir, entry), join10(installDir, entry));
   }
-  const destination = join9(installDir, "bin", executableName);
-  if (!existsSync5(destination))
+  const destination = join10(installDir, "bin", executableName);
+  if (!existsSync6(destination))
     throw new Error(`CodeGraph archive did not contain bin/${executableName}`);
   await chmod2(destination, 493);
   return destination;
 }
 async function installAsset(layout) {
   const { asset, downloader, installDir, version } = layout;
-  const stagingDir = join9(installDir, ".staging", randomUUID2());
-  const archivePath = join9(stagingDir, basename3(asset.url));
-  const extractDir = join9(stagingDir, "extract");
+  const stagingDir = join10(installDir, ".staging", randomUUID2());
+  const archivePath = join10(stagingDir, basename4(asset.url));
+  const extractDir = join10(stagingDir, "extract");
   try {
     await mkdir2(extractDir, { recursive: true });
     const bytes = await downloader(asset);
     const actualChecksum = sha2562(bytes);
     if (actualChecksum !== asset.sha256) {
-      throw new Error(`checksum mismatch for ${basename3(asset.url)}: expected ${asset.sha256}, got ${actualChecksum}`);
+      throw new Error(`checksum mismatch for ${basename4(asset.url)}: expected ${asset.sha256}, got ${actualChecksum}`);
     }
     if (!asset.url.endsWith(".tar.gz") && !asset.url.endsWith(".tgz")) {
-      throw new Error(`unsupported CodeGraph archive type for ${basename3(asset.url)}`);
+      throw new Error(`unsupported CodeGraph archive type for ${basename4(asset.url)}`);
     }
     await writeFile3(archivePath, bytes);
     await extractTarGz(archivePath, extractDir);
     const destination = await installExtractedBundle(extractDir, installDir, asset.executableName);
-    await mkdir2(join9(installDir, ".provisioned"), { recursive: true });
+    await mkdir2(join10(installDir, ".provisioned"), { recursive: true });
     await writeFile3(markerPath(installDir, version), `${JSON.stringify({ binPath: destination, version })}
 `);
     return destination;
   } finally {
     await rm2(stagingDir, { force: true, recursive: true });
-    await removeEmptyDirectory(join9(installDir, ".staging"));
+    await removeEmptyDirectory(join10(installDir, ".staging"));
   }
 }
 async function ensureCodegraphProvisioned(options) {
@@ -6011,7 +6206,7 @@ async function ensureCodegraphProvisioned(options) {
   const existing = await readMarker(marker);
   if (existing !== null)
     return { binPath: existing, provisioned: true };
-  const lockPath = join9(options.lockDir, `codegraph-${hostname()}.lock`);
+  const lockPath = join10(options.lockDir, `codegraph-${hostname()}.lock`);
   const release = await acquireLock(lockPath, options.lockWaitMs ?? DEFAULT_LOCK_WAIT_MS, options.lockStaleMs ?? DEFAULT_LOCK_STALE_MS);
   if (release === null)
     return { error: "timed out waiting for codegraph provisioning lock", provisioned: false };
@@ -6041,10 +6236,10 @@ var init_provision = __esm(() => {
 });
 
 // packages/utils/src/codegraph/resolve.ts
-import { existsSync as existsSync6 } from "fs";
-import { homedir as homedir4 } from "os";
+import { existsSync as existsSync7 } from "fs";
+import { homedir as homedir6 } from "os";
 import { spawnSync as spawnSync2 } from "child_process";
-import { basename as basename4, dirname as dirname3, join as join10 } from "path";
+import { basename as basename5, dirname as dirname3, join as join11 } from "path";
 import { createRequire } from "module";
 function defaultRequireResolve(specifier) {
   return requireFromHere.resolve(specifier);
@@ -6070,7 +6265,7 @@ ${result.stderr}`.trim().split(/\s+/)[0];
   }
 }
 function isNodeExecutableName(filePath) {
-  const executable = basename4(filePath).toLowerCase();
+  const executable = basename5(filePath).toLowerCase();
   return executable === "node" || executable === "node.exe" || /^node\d+(\.exe)?$/.test(executable);
 }
 function looksLikePath(command) {
@@ -6109,7 +6304,7 @@ function defaultNodeRuntime(env, fileExists, which2, nodeVersion) {
 }
 function resolveCodegraphNodeRuntime(options = {}) {
   const env = options.env ?? process.env;
-  return defaultNodeRuntime(env, options.fileExists ?? existsSync6, options.which ?? bunWhich, options.nodeVersion ?? defaultNodeVersion);
+  return defaultNodeRuntime(env, options.fileExists ?? existsSync7, options.which ?? bunWhich, options.nodeVersion ?? defaultNodeVersion);
 }
 function resolveCodegraphNodeSupport(options = {}) {
   const env = options.env ?? process.env;
@@ -6123,8 +6318,8 @@ function resolveCodegraphNodeSupport(options = {}) {
 function defaultProvisionedBin(homeDir, fileExists) {
   const binaryName = process.platform === "win32" ? "codegraph.cmd" : "codegraph";
   const candidates = [
-    join10(homeDir, ".omo", "codegraph", "bin", binaryName),
-    join10(homeDir, ".omo", "codegraph", "node-servers", "node_modules", ".bin", binaryName)
+    join11(homeDir, ".omo", "codegraph", "bin", binaryName),
+    join11(homeDir, ".omo", "codegraph", "node-servers", "node_modules", ".bin", binaryName)
   ];
   return candidates.find((candidate) => fileExists(candidate)) ?? null;
 }
@@ -6132,7 +6327,7 @@ function resolveBundledShim(requireResolve, fileExists) {
   try {
     const packageJson = requireResolve(`${CODEGRAPH_PACKAGE}/package.json`);
     const packageRoot = dirname3(packageJson);
-    const candidates = [join10(packageRoot, "bin", "codegraph.js"), join10(packageRoot, "npm-shim.js")];
+    const candidates = [join11(packageRoot, "bin", "codegraph.js"), join11(packageRoot, "npm-shim.js")];
     return candidates.find((candidate) => fileExists(candidate)) ?? null;
   } catch (error) {
     if (error instanceof Error)
@@ -6148,7 +6343,7 @@ function resolveBundledShim(requireResolve, fileExists) {
 }
 function resolveCodegraphCommand(options = {}) {
   const env = options.env ?? process.env;
-  const fileExists = options.fileExists ?? existsSync6;
+  const fileExists = options.fileExists ?? existsSync7;
   const configuredBin = env[CODEGRAPH_ENV_BIN]?.trim() || env[CODEGRAPH_LEGACY_ENV_BIN]?.trim();
   if (configuredBin !== undefined && configuredBin.length > 0) {
     return { argsPrefix: [], command: configuredBin, exists: fileExists(configuredBin), source: "env" };
@@ -6160,7 +6355,7 @@ function resolveCodegraphCommand(options = {}) {
   if (bundled !== null && runtime4 !== null) {
     return { argsPrefix: [bundled], command: runtime4, exists: true, source: "bundled" };
   }
-  const provisioned = options.provisioned?.() ?? defaultProvisionedBin(options.homeDir ?? homedir4(), fileExists);
+  const provisioned = options.provisioned?.() ?? defaultProvisionedBin(options.homeDir ?? homedir6(), fileExists);
   if (provisioned !== null && fileExists(provisioned)) {
     return { argsPrefix: [], command: provisioned, exists: true, source: "provisioned" };
   }
@@ -6179,115 +6374,19 @@ var init_resolve2 = __esm(() => {
   requireFromHere = createRequire(import.meta.url);
 });
 
-// packages/utils/src/codegraph/workspace.ts
-import { createHash as createHash3 } from "crypto";
-import {
-  appendFileSync as appendFileSync2,
-  existsSync as existsSync7,
-  lstatSync as lstatSync2,
-  mkdirSync as mkdirSync2,
-  readFileSync as readFileSync2,
-  readdirSync,
-  realpathSync as realpathSync3,
-  rmSync,
-  statSync as statSync3,
-  symlinkSync
-} from "fs";
-import { homedir as homedir5 } from "os";
-import { basename as basename5, join as join11, resolve as resolve4 } from "path";
-function sanitizeBase(value) {
-  const sanitized = value.replace(/[^A-Za-z0-9._-]/g, "-").replace(/-+/g, "-");
-  return sanitized.length > 0 ? sanitized : "workspace";
-}
-function codegraphDataRoot(homeDir) {
-  return join11(homeDir, ".omo", "codegraph");
-}
-function workspaceStorageName(workspace) {
-  const resolved = resolve4(workspace);
-  const hash = createHash3("sha256").update(resolved).digest("hex").slice(0, 16);
-  return `${sanitizeBase(basename5(resolved))}-${hash}`;
-}
-function fallbackResult(dataRoot, projectLink, reason) {
-  return { dataDir: projectLink, dataRoot, linked: false, mode: "in-place-fallback", projectLink, reason };
-}
-function isSameFilesystem(workspace, dataRoot, override) {
-  if (override !== undefined)
-    return override;
-  return statSync3(workspace).dev === statSync3(dataRoot).dev;
-}
-function ensureInPlaceFallback(projectLink) {
-  if (!existsSync7(projectLink))
-    mkdirSync2(projectLink, { recursive: true });
-}
-function prepareCodegraphWorkspace(workspace, options = {}) {
-  const resolvedWorkspace = resolve4(workspace);
-  const dataRoot = codegraphDataRoot(options.homeDir ?? homedir5());
-  const dataDir = join11(dataRoot, "projects", workspaceStorageName(resolvedWorkspace));
-  const projectLink = join11(resolvedWorkspace, ".codegraph");
-  try {
-    mkdirSync2(dataDir, { recursive: true });
-    if (existsSync7(projectLink)) {
-      const linkStat = lstatSync2(projectLink);
-      if (!linkStat.isSymbolicLink()) {
-        return { dataDir: projectLink, dataRoot, linked: false, mode: "in-project", projectLink };
-      }
-      if (realpathSync3(projectLink) === realpathSync3(dataDir)) {
-        return { dataDir, dataRoot, linked: true, mode: "global-linked", projectLink };
-      }
-      return fallbackResult(dataRoot, projectLink, "existing .codegraph symlink points outside OMO store");
-    }
-    if (!isSameFilesystem(resolvedWorkspace, dataRoot, options.sameFilesystem)) {
-      ensureInPlaceFallback(projectLink);
-      return fallbackResult(dataRoot, projectLink, "workspace and OMO store are on different filesystems");
-    }
-    const symlink = options.symlink ?? symlinkSync;
-    symlink(dataDir, projectLink, (options.platform ?? process.platform) === "win32" ? "junction" : "dir");
-    return { dataDir, dataRoot, linked: true, mode: "global-linked", projectLink };
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    try {
-      ensureInPlaceFallback(projectLink);
-    } catch (fallbackError) {
-      return fallbackResult(dataRoot, projectLink, `${reason}; fallback failed: ${String(fallbackError)}`);
-    }
-    return fallbackResult(dataRoot, projectLink, reason);
-  }
-}
-function ensureCodegraphGitignored(workspace) {
-  const gitDir = join11(workspace, ".git");
-  if (!existsSync7(gitDir))
-    return false;
-  const excludePath = join11(gitDir, "info", "exclude");
-  try {
-    mkdirSync2(join11(gitDir, "info"), { recursive: true });
-    const existing = existsSync7(excludePath) ? readFileSync2(excludePath, "utf8") : "";
-    if (existing.split(/\r?\n/).includes(".codegraph"))
-      return true;
-    appendFileSync2(excludePath, `${existing.endsWith(`
-`) || existing.length === 0 ? "" : `
-`}.codegraph
-`);
-    return true;
-  } catch (error) {
-    if (error instanceof Error)
-      return false;
-    throw error;
-  }
-}
-var init_workspace = () => {};
-
 // packages/utils/src/codegraph/index.ts
 var init_codegraph = __esm(() => {
   init_env();
+  init_guidance();
   init_provision();
   init_resolve2();
   init_workspace();
 });
 
 // packages/utils/src/command-executor/home-directory.ts
-import { homedir as homedir6 } from "os";
+import { homedir as homedir7 } from "os";
 function getHomeDirectory() {
-  return process.env.HOME || process.env.USERPROFILE || homedir6();
+  return process.env.HOME || process.env.USERPROFILE || homedir7();
 }
 var init_home_directory = () => {};
 
@@ -12779,7 +12878,7 @@ var init_types2 = __esm(() => {
 
 // packages/team-core/src/team-registry/paths.ts
 import { mkdir as mkdir3, readdir as readdir2, stat as stat2, chmod as chmod3 } from "fs/promises";
-import { homedir as homedir22 } from "os";
+import { homedir as homedir23 } from "os";
 import path14 from "path";
 function getTeamDirectory(baseDir, teamName, scope, projectRoot) {
   if (scope === "project") {
@@ -12802,7 +12901,7 @@ function resolveContainedPath2(baseDir, pathSegments) {
   return resolvedPath;
 }
 function resolveBaseDir(config) {
-  return config.base_dir ?? path14.join(homedir22(), ".omo");
+  return config.base_dir ?? path14.join(homedir23(), ".omo");
 }
 function getTeamSpecPath(baseDir, teamName, scope, projectRoot) {
   return path14.join(getTeamDirectory(baseDir, teamName, scope, projectRoot), "config.json");
@@ -20506,7 +20605,7 @@ init_command_executor();
 init_src();
 // packages/omo-opencode/src/shared/file-reference-resolver.ts
 import { existsSync as existsSync10, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
-import { homedir as homedir7 } from "os";
+import { homedir as homedir8 } from "os";
 import { isAbsolute as isAbsolute4, posix, resolve as resolve7, win32 } from "path";
 init_logger2();
 var FILE_REFERENCE_PATTERN = /@([^\s@]+)/g;
@@ -20525,7 +20624,7 @@ function expandEnvironmentVariable(match, variableName) {
     return value;
   }
   if (variableName === "HOME") {
-    return homedir7();
+    return homedir8();
   }
   return match;
 }
@@ -22025,7 +22124,7 @@ function extractRuntimeFallbackAutoRetrySignal(info) {
 }
 // packages/model-core/src/runtime-fallback-error-shape.ts
 var DEFAULT_RETRY_ON_ERRORS = [429, 500, 502, 503, 504];
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 function getRecordValue(record, key) {
@@ -22033,14 +22132,14 @@ function getRecordValue(record, key) {
 }
 function getNestedRecord(record, key) {
   const value = getRecordValue(record, key);
-  return isRecord2(value) ? value : undefined;
+  return isRecord3(value) ? value : undefined;
 }
 function getRuntimeFallbackErrorMessage(error) {
   if (!error)
     return "";
   if (typeof error === "string")
     return error.toLowerCase();
-  if (!isRecord2(error)) {
+  if (!isRecord3(error)) {
     try {
       return JSON.stringify(error).toLowerCase();
     } catch (error2) {
@@ -22076,7 +22175,7 @@ function getRuntimeFallbackErrorMessage(error) {
   }
 }
 function getRuntimeFallbackStatusCode(error, retryOnErrors) {
-  if (isRecord2(error)) {
+  if (isRecord3(error)) {
     const topLevelStatusCode = getRecordValue(error, "statusCode");
     if (typeof topLevelStatusCode === "number")
       return topLevelStatusCode;
@@ -22084,7 +22183,7 @@ function getRuntimeFallbackStatusCode(error, retryOnErrors) {
     if (typeof topLevelStatus === "number")
       return topLevelStatus;
   }
-  const root = isRecord2(error) ? error : undefined;
+  const root = isRecord3(error) ? error : undefined;
   const data = getNestedRecord(root, "data");
   const nestedError = getNestedRecord(root, "error");
   const cause = getNestedRecord(root, "cause");
@@ -22103,7 +22202,7 @@ function getRuntimeFallbackStatusCode(error, retryOnErrors) {
   return;
 }
 function getRuntimeFallbackErrorName(error) {
-  if (!isRecord2(error))
+  if (!isRecord3(error))
     return;
   const data = getNestedRecord(error, "data");
   const nestedError = getNestedRecord(error, "error");
@@ -22118,7 +22217,7 @@ function getRuntimeFallbackErrorName(error) {
   return;
 }
 function getRuntimeFallbackRetryableSignal(error) {
-  if (!isRecord2(error))
+  if (!isRecord3(error))
     return;
   const data = getNestedRecord(error, "data");
   const nestedError = getNestedRecord(error, "error");
@@ -22324,7 +22423,7 @@ function getBundledModelCapabilitiesSnapshot(snapshotJson) {
   };
 }
 // packages/model-core/src/model-capabilities/runtime-model-readers.ts
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readNumber(value) {
@@ -22342,7 +22441,7 @@ function normalizeVariantKeys(value) {
   if (arrayVariants) {
     return arrayVariants.filter((v) => typeof v === "string").map((variant) => variant.toLowerCase());
   }
-  if (!isRecord3(value)) {
+  if (!isRecord4(value)) {
     return;
   }
   const variants = Object.keys(value).map((variant) => variant.toLowerCase());
@@ -22353,7 +22452,7 @@ function readModalityKeys(value) {
   if (stringArray) {
     return stringArray.filter((entry) => typeof entry === "string").map((entry) => entry.toLowerCase());
   }
-  if (!isRecord3(value)) {
+  if (!isRecord4(value)) {
     return;
   }
   const fromNested = Object.values(value).filter((v) => Array.isArray(v)).flat().filter((item) => typeof item === "string");
@@ -22364,7 +22463,7 @@ function readModalityKeys(value) {
   return enabled.length > 0 ? enabled : undefined;
 }
 function normalizeModalities(value) {
-  if (!isRecord3(value)) {
+  if (!isRecord4(value)) {
     return;
   }
   const input = readModalityKeys(value.input);
@@ -22378,7 +22477,7 @@ function normalizeModalities(value) {
   };
 }
 function readRuntimeModelCapabilities(runtimeModel) {
-  return isRecord3(runtimeModel?.capabilities) ? runtimeModel.capabilities : undefined;
+  return isRecord4(runtimeModel?.capabilities) ? runtimeModel.capabilities : undefined;
 }
 function readRuntimeModelBoolean(runtimeModel, keys) {
   const runtimeCapabilities = readRuntimeModelCapabilities(runtimeModel);
@@ -22395,7 +22494,7 @@ function readRuntimeModelBoolean(runtimeModel, keys) {
   return;
 }
 function readRuntimeModel(runtimeModel) {
-  return isRecord3(runtimeModel) ? runtimeModel : undefined;
+  return isRecord4(runtimeModel) ? runtimeModel : undefined;
 }
 function readRuntimeModelVariants(runtimeModel) {
   const rootVariants = normalizeVariantKeys(runtimeModel?.variants);
@@ -22443,8 +22542,8 @@ function readRuntimeModelToolCallSupport(runtimeModel) {
   return readRuntimeModelBoolean(runtimeModel, ["toolCall", "tool_call", "toolcall"]);
 }
 function readRuntimeModelLimitOutput(runtimeModel) {
-  const limit = isRecord3(runtimeModel?.limit) ? runtimeModel.limit : readRuntimeModelCapabilities(runtimeModel)?.limit;
-  if (!isRecord3(limit)) {
+  const limit = isRecord4(runtimeModel?.limit) ? runtimeModel.limit : readRuntimeModelCapabilities(runtimeModel)?.limit;
+  if (!isRecord4(limit)) {
     return;
   }
   const output = readNumber(limit.output);
@@ -22561,7 +22660,7 @@ function resolveActualContextLimit(providerID, modelID, modelCacheState) {
 }
 // packages/model-core/src/model-capabilities-snapshot.ts
 var MODELS_DEV_SOURCE_URL = "https://models.dev/api.json";
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readBoolean(value) {
@@ -22581,7 +22680,7 @@ function readStringArray2(value) {
   return result.length > 0 ? result : undefined;
 }
 function normalizeSnapshotEntry(rawModelID, rawModel) {
-  if (!isRecord4(rawModel)) {
+  if (!isRecord5(rawModel)) {
     return;
   }
   const id = readString(rawModel.id) ?? rawModelID;
@@ -22589,14 +22688,14 @@ function normalizeSnapshotEntry(rawModelID, rawModel) {
   const reasoning = readBoolean(rawModel.reasoning);
   const temperature = readBoolean(rawModel.temperature);
   const toolCall = readBoolean(rawModel.tool_call);
-  const rawModalities = isRecord4(rawModel.modalities) ? rawModel.modalities : undefined;
+  const rawModalities = isRecord5(rawModel.modalities) ? rawModel.modalities : undefined;
   const modalitiesInput = readStringArray2(rawModalities?.input);
   const modalitiesOutput = readStringArray2(rawModalities?.output);
   const modalities = modalitiesInput || modalitiesOutput ? {
     ...modalitiesInput ? { input: modalitiesInput } : {},
     ...modalitiesOutput ? { output: modalitiesOutput } : {}
   } : undefined;
-  const rawLimit = isRecord4(rawModel.limit) ? rawModel.limit : undefined;
+  const rawLimit = isRecord5(rawModel.limit) ? rawModel.limit : undefined;
   const limitContext = readNumber2(rawLimit?.context);
   const limitInput = readNumber2(rawLimit?.input);
   const limitOutput = readNumber2(rawLimit?.output);
@@ -22636,13 +22735,13 @@ function mergeSnapshotEntries(existing, incoming) {
 }
 function buildModelCapabilitiesSnapshotFromModelsDev(raw) {
   const models = {};
-  const providers = isRecord4(raw) ? raw : {};
+  const providers = isRecord5(raw) ? raw : {};
   for (const providerValue of Object.values(providers)) {
-    if (!isRecord4(providerValue)) {
+    if (!isRecord5(providerValue)) {
       continue;
     }
     const providerModels = providerValue.models;
-    if (!isRecord4(providerModels)) {
+    if (!isRecord5(providerModels)) {
       continue;
     }
     for (const [rawModelID, rawModel] of Object.entries(providerModels)) {
@@ -23059,14 +23158,14 @@ function addConfigLoadError(error) {
   configLoadErrors.push(error);
 }
 // packages/omo-opencode/src/shared/claude-config-dir.ts
-import { homedir as homedir9 } from "os";
+import { homedir as homedir10 } from "os";
 import { join as join14 } from "path";
 function getClaudeConfigDir() {
   const envConfigDir = process.env.CLAUDE_CONFIG_DIR;
   if (envConfigDir) {
     return envConfigDir;
   }
-  return join14(homedir9(), ".claude");
+  return join14(homedir10(), ".claude");
 }
 // packages/omo-opencode/src/shared/jsonc-parser.ts
 init_src();
@@ -23911,7 +24010,7 @@ configureMigrationCategoryDefaults(DEFAULT_CATEGORIES);
 // packages/omo-opencode/src/shared/opencode-config-dir.ts
 init_plugin_identity();
 import { existsSync as existsSync11, realpathSync as realpathSync4 } from "fs";
-import { homedir as homedir10 } from "os";
+import { homedir as homedir11 } from "os";
 import { join as join15, posix as posix2, resolve as resolve8, win32 as win322 } from "path";
 var TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
 var TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
@@ -23924,14 +24023,14 @@ function getTauriConfigDir(identifier) {
   const platform = process.platform;
   switch (platform) {
     case "darwin":
-      return join15(homedir10(), "Library", "Application Support", identifier);
+      return join15(homedir11(), "Library", "Application Support", identifier);
     case "win32": {
-      const appData = process.env.APPDATA || join15(homedir10(), "AppData", "Roaming");
+      const appData = process.env.APPDATA || join15(homedir11(), "AppData", "Roaming");
       return win322.join(appData, identifier);
     }
     case "linux":
     default: {
-      const xdgConfig = process.env.XDG_CONFIG_HOME || join15(homedir10(), ".config");
+      const xdgConfig = process.env.XDG_CONFIG_HOME || join15(homedir11(), ".config");
       return join15(xdgConfig, identifier);
     }
   }
@@ -23975,7 +24074,7 @@ function getWslLinuxHomeDir(windowsConfigRoot) {
 function getCliDefaultConfigDir() {
   const envXdgConfig = process.env.XDG_CONFIG_HOME?.trim();
   const shouldIgnoreWindowsXdg = envXdgConfig !== undefined && envXdgConfig.length > 0 && isWslEnvironment() && isWindowsUserConfigRoot(envXdgConfig);
-  const xdgConfig = shouldIgnoreWindowsXdg ? posix2.join(getWslLinuxHomeDir(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join15(homedir10(), ".config");
+  const xdgConfig = shouldIgnoreWindowsXdg ? posix2.join(getWslLinuxHomeDir(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join15(homedir11(), ".config");
   const configDir = isWslEnvironment() ? posix2.join(xdgConfig, "opencode") : join15(xdgConfig, "opencode");
   return resolveConfigPath(configDir);
 }
@@ -24028,12 +24127,12 @@ function getOpenCodeConfigPaths(options) {
   };
 }
 // packages/omo-opencode/src/shared/resolve-agent-definition-paths.ts
-import { homedir as homedir11 } from "os";
+import { homedir as homedir12 } from "os";
 import { isAbsolute as isAbsolute5, join as join16, resolve as resolve9 } from "path";
 init_logger2();
 function resolveAgentDefinitionPaths(paths, baseDir, containmentDir) {
   return paths.flatMap((p) => {
-    const expanded = p.startsWith("~/") ? join16(homedir11(), p.slice(2)) : p;
+    const expanded = p.startsWith("~/") ? join16(homedir12(), p.slice(2)) : p;
     const resolved = isAbsolute5(expanded) ? expanded : resolve9(baseDir, expanded);
     if (containmentDir !== null && !isWithinProject(resolved, containmentDir)) {
       log2(`agent_definitions path rejected (outside project boundary): ${p} -> ${resolved}`);
@@ -70666,7 +70765,7 @@ var log4 = logger4.log;
 var getLogFilePath2 = logger4.getLogFilePath;
 
 // packages/claude-code-compat-core/src/features/claude-code-plugin-loader/scope-filter.ts
-import { homedir as homedir13 } from "os";
+import { homedir as homedir14 } from "os";
 import { join as join29 } from "path";
 
 // packages/claude-code-compat-core/src/shared/contains-path.ts
@@ -70675,10 +70774,10 @@ init_src();
 // packages/claude-code-compat-core/src/features/claude-code-plugin-loader/scope-filter.ts
 function expandTilde(inputPath) {
   if (inputPath === "~") {
-    return homedir13();
+    return homedir14();
   }
   if (inputPath.startsWith("~/") || inputPath.startsWith("~\\")) {
-    return join29(homedir13(), inputPath.slice(2));
+    return join29(homedir14(), inputPath.slice(2));
   }
   return inputPath;
 }
@@ -70693,13 +70792,13 @@ function shouldLoadPluginForCwd(installation, cwd = process.cwd()) {
 }
 
 // packages/claude-code-compat-core/src/features/claude-code-plugin-loader/discovery-paths.ts
-import { homedir as homedir14 } from "os";
+import { homedir as homedir15 } from "os";
 import { join as join30 } from "path";
 function getPluginsBaseDir() {
   if (process.env.CLAUDE_PLUGINS_HOME) {
     return process.env.CLAUDE_PLUGINS_HOME;
   }
-  return join30(homedir14(), ".claude", "plugins");
+  return join30(homedir15(), ".claude", "plugins");
 }
 function getInstalledPluginsPath(pluginsBaseDir) {
   return join30(pluginsBaseDir ?? getPluginsBaseDir(), "installed_plugins.json");
@@ -70708,7 +70807,7 @@ function getClaudeSettingsPath() {
   if (process.env.CLAUDE_SETTINGS_PATH) {
     return process.env.CLAUDE_SETTINGS_PATH;
   }
-  return join30(homedir14(), ".claude", "settings.json");
+  return join30(homedir15(), ".claude", "settings.json");
 }
 
 // packages/claude-code-compat-core/src/features/claude-code-plugin-loader/installed-plugin-database.ts
@@ -74183,7 +74282,7 @@ async function runCommentChecker(input, options) {
 // packages/omo-opencode/src/hooks/comment-checker/downloader.ts
 import { existsSync as existsSync37, appendFileSync as appendFileSync3 } from "fs";
 import { join as join43 } from "path";
-import { homedir as homedir15, tmpdir as tmpdir3 } from "os";
+import { homedir as homedir16, tmpdir as tmpdir3 } from "os";
 import { createRequire as createRequire3 } from "module";
 init_logger2();
 init_plugin_identity();
@@ -74207,11 +74306,11 @@ var PLATFORM_MAP = {
 function getCacheDir2() {
   if (process.platform === "win32") {
     const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
-    const base2 = localAppData || join43(homedir15(), "AppData", "Local");
+    const base2 = localAppData || join43(homedir16(), "AppData", "Local");
     return join43(base2, CACHE_DIR_NAME, "bin");
   }
   const xdgCache = process.env.XDG_CACHE_HOME;
-  const base = xdgCache || join43(homedir15(), ".cache");
+  const base = xdgCache || join43(homedir16(), ".cache");
   return join43(base, CACHE_DIR_NAME, "bin");
 }
 function getBinaryName() {
@@ -74823,7 +74922,7 @@ function isSameOrChildPath(childPath, parentPath) {
 }
 // packages/rules-engine/src/finder.ts
 import { existsSync as existsSync42, statSync as statSync6 } from "fs";
-import { homedir as homedir16 } from "os";
+import { homedir as homedir17 } from "os";
 import { dirname as dirname13, isAbsolute as isAbsolute9, join as join48, relative as relative8, resolve as resolve14 } from "path";
 
 // packages/rules-engine/src/ordering.ts
@@ -74922,7 +75021,7 @@ function findRuleFiles(projectRoot, homeDir, currentFile, options, cache) {
   const seenRealPaths = new Set;
   addProjectRuleCandidates(effectiveProjectRoot, startDir, candidates, seenRealPaths, cache);
   addProjectSingleFileCandidates(effectiveProjectRoot, candidates, seenRealPaths);
-  addUserRuleCandidates(homeDir || homedir16(), skipClaudeUserRules, candidates, seenRealPaths, cache);
+  addUserRuleCandidates(homeDir || homedir17(), skipClaudeUserRules, candidates, seenRealPaths, cache);
   const sorted = sortCandidates(candidates);
   cache?.set(cacheKey, sorted);
   return sorted;
@@ -80011,7 +80110,7 @@ function createSessionRuleScanCacheStore() {
 }
 
 // packages/omo-opencode/src/hooks/rules-injector/injection-processor.ts
-import { homedir as homedir17 } from "os";
+import { homedir as homedir18 } from "os";
 // packages/omo-opencode/src/hooks/rules-injector/rule-file-finder.ts
 init_logger2();
 setSisyphusRuleDeprecationLogger(log2);
@@ -80157,7 +80256,7 @@ function createRuleInjectionProcessor(deps) {
     getSessionCache: getSessionCache3,
     getSessionRuleScanCache,
     ruleFinderOptions,
-    homedir: getHomeDir = homedir17,
+    homedir: getHomeDir = homedir18,
     shouldApplyRule: shouldApplyRuleImpl = shouldApplyRule,
     isDuplicateByRealPath: isDuplicateByRealPathImpl = isDuplicateByRealPath,
     createContentHash: createContentHashImpl = createContentHash,
@@ -80683,7 +80782,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "oh-my-opencode",
-  version: "4.12.0",
+  version: "4.12.1",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -80853,18 +80952,18 @@ var package_default = {
     typescript: "^6.0.3"
   },
   optionalDependencies: {
-    "oh-my-opencode-darwin-arm64": "4.12.0",
-    "oh-my-opencode-darwin-x64": "4.12.0",
-    "oh-my-opencode-darwin-x64-baseline": "4.12.0",
-    "oh-my-opencode-linux-arm64": "4.12.0",
-    "oh-my-opencode-linux-arm64-musl": "4.12.0",
-    "oh-my-opencode-linux-x64": "4.12.0",
-    "oh-my-opencode-linux-x64-baseline": "4.12.0",
-    "oh-my-opencode-linux-x64-musl": "4.12.0",
-    "oh-my-opencode-linux-x64-musl-baseline": "4.12.0",
-    "oh-my-opencode-windows-arm64": "4.12.0",
-    "oh-my-opencode-windows-x64": "4.12.0",
-    "oh-my-opencode-windows-x64-baseline": "4.12.0"
+    "oh-my-opencode-darwin-arm64": "4.12.1",
+    "oh-my-opencode-darwin-x64": "4.12.1",
+    "oh-my-opencode-darwin-x64-baseline": "4.12.1",
+    "oh-my-opencode-linux-arm64": "4.12.1",
+    "oh-my-opencode-linux-arm64-musl": "4.12.1",
+    "oh-my-opencode-linux-x64": "4.12.1",
+    "oh-my-opencode-linux-x64-baseline": "4.12.1",
+    "oh-my-opencode-linux-x64-musl": "4.12.1",
+    "oh-my-opencode-linux-x64-musl-baseline": "4.12.1",
+    "oh-my-opencode-windows-arm64": "4.12.1",
+    "oh-my-opencode-windows-x64": "4.12.1",
+    "oh-my-opencode-windows-x64-baseline": "4.12.1"
   },
   overrides: {
     hono: "^4.12.18",
@@ -81855,7 +81954,7 @@ v${latestVersion} available. Restart OpenCode to apply.` : "OpenCode is now on S
 // packages/omo-opencode/src/hooks/codegraph-bootstrap/hook.ts
 init_src();
 import { existsSync as existsSync65 } from "fs";
-import { homedir as homedir20 } from "os";
+import { homedir as homedir21 } from "os";
 import { join as join75 } from "path";
 
 // packages/omo-opencode/src/hooks/codegraph-bootstrap/command-runner.ts
@@ -82003,7 +82102,7 @@ function defaultSchedule(task) {
   timer.unref?.();
 }
 function defaultInstallDir2() {
-  return join75(homedir20(), ".omo", "codegraph");
+  return join75(homedir21(), ".omo", "codegraph");
 }
 function provisionedBinFromInstallDir(installDir) {
   if (installDir === undefined)
@@ -82134,7 +82233,7 @@ function createCodegraphBootstrapHook(ctx, config, depsOverride = {}) {
 }
 // packages/omo-opencode/src/hooks/ast-grep-sg-provision/hook.ts
 init_src();
-import { homedir as homedir21 } from "os";
+import { homedir as homedir22 } from "os";
 import { join as join76 } from "path";
 var provisionedTargets = new Set;
 function defaultSchedule2(task) {
@@ -82154,7 +82253,7 @@ async function runProvision(targetDir, deps) {
 }
 var defaultDeps5 = {
   findSgBinary: findSgBinarySync,
-  homeDir: homedir21,
+  homeDir: homedir22,
   log: log2,
   provisionSgBinary,
   schedule: defaultSchedule2
@@ -90356,7 +90455,7 @@ import { dirname as dirname28 } from "path";
 init_resolve_commands_in_text();
 // packages/skills-loader-core/src/features/opencode-skill-loader/loader.ts
 import { join as join88 } from "path";
-import { homedir as homedir25 } from "os";
+import { homedir as homedir26 } from "os";
 
 // packages/shared-skills/index.mjs
 import { fileURLToPath as fileURLToPath5 } from "url";
@@ -90365,21 +90464,21 @@ function sharedSkillsRootPath() {
 }
 
 // packages/skills-loader-core/src/shared/claude-config-dir.ts
-import { homedir as homedir23 } from "os";
+import { homedir as homedir24 } from "os";
 import { join as join82 } from "path";
 function getClaudeConfigDir2() {
   const envConfigDir = process.env.CLAUDE_CONFIG_DIR;
   if (envConfigDir) {
     return envConfigDir;
   }
-  return join82(homedir23(), ".claude");
+  return join82(homedir24(), ".claude");
 }
 // packages/skills-loader-core/src/shared/opencode-command-dirs.ts
 import { basename as basename13, dirname as dirname24, join as join84 } from "path";
 
 // packages/skills-loader-core/src/shared/opencode-config-dir.ts
 import { existsSync as existsSync70, realpathSync as realpathSync11 } from "fs";
-import { homedir as homedir24 } from "os";
+import { homedir as homedir25 } from "os";
 import { join as join83, posix as posix4, resolve as resolve19, win32 as win325 } from "path";
 
 // packages/skills-loader-core/src/shared/plugin-identity.ts
@@ -90413,14 +90512,14 @@ function getTauriConfigDir2(identifier) {
   const platform2 = process.platform;
   switch (platform2) {
     case "darwin":
-      return join83(homedir24(), "Library", "Application Support", identifier);
+      return join83(homedir25(), "Library", "Application Support", identifier);
     case "win32": {
-      const appData = process.env.APPDATA || join83(homedir24(), "AppData", "Roaming");
+      const appData = process.env.APPDATA || join83(homedir25(), "AppData", "Roaming");
       return win325.join(appData, identifier);
     }
     case "linux":
     default: {
-      const xdgConfig = process.env.XDG_CONFIG_HOME || join83(homedir24(), ".config");
+      const xdgConfig = process.env.XDG_CONFIG_HOME || join83(homedir25(), ".config");
       return join83(xdgConfig, identifier);
     }
   }
@@ -90464,7 +90563,7 @@ function getWslLinuxHomeDir2(windowsConfigRoot) {
 function getCliDefaultConfigDir2() {
   const envXdgConfig = process.env.XDG_CONFIG_HOME?.trim();
   const shouldIgnoreWindowsXdg = envXdgConfig !== undefined && envXdgConfig.length > 0 && isWslEnvironment2() && isWindowsUserConfigRoot2(envXdgConfig);
-  const xdgConfig = shouldIgnoreWindowsXdg ? posix4.join(getWslLinuxHomeDir2(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join83(homedir24(), ".config");
+  const xdgConfig = shouldIgnoreWindowsXdg ? posix4.join(getWslLinuxHomeDir2(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join83(homedir25(), ".config");
   const configDir = isWslEnvironment2() ? posix4.join(xdgConfig, "opencode") : join83(xdgConfig, "opencode");
   return resolveConfigPath2(configDir);
 }
@@ -91039,7 +91138,7 @@ async function loadProjectAgentsSkills(directory) {
   const allSkills = await Promise.all(agentsProjectSkillDirs.map((skillsDir) => loadSkillsFromDir({ skillsDir, scope: "project" })));
   return skillsToCommandDefinitionRecord(deduplicateSkillsByName(allSkills.flat()));
 }
-async function loadGlobalAgentsSkills(homeDirectory = homedir25()) {
+async function loadGlobalAgentsSkills(homeDirectory = homedir26()) {
   const agentsGlobalDir = join88(homeDirectory, ".agents", "skills");
   const skills = await loadSkillsFromDir({ skillsDir: agentsGlobalDir, scope: "user" });
   return skillsToCommandDefinitionRecord(skills);
@@ -91137,7 +91236,7 @@ async function discoverProjectAgentsSkills(directory) {
   const allSkills = await Promise.all(agentsProjectSkillDirs.map((skillsDir) => loadSkillsFromDir({ skillsDir, scope: "project" })));
   return deduplicateSkillsByName(allSkills.flat());
 }
-async function discoverGlobalAgentsSkills(homeDirectory = homedir25()) {
+async function discoverGlobalAgentsSkills(homeDirectory = homedir26()) {
   const agentsGlobalDir = join88(homeDirectory, ".agents", "skills");
   return loadSkillsFromDir({ skillsDir: agentsGlobalDir, scope: "user" });
 }
@@ -91168,14 +91267,14 @@ function builtinToLoadedSkill(builtin) {
 init_src();
 import { existsSync as existsSync72, readFileSync as readFileSync46 } from "fs";
 import { dirname as dirname26, isAbsolute as isAbsolute13, resolve as resolve22 } from "path";
-import { homedir as homedir26 } from "os";
+import { homedir as homedir27 } from "os";
 function resolveFilePath5(from, configDir) {
   let filePath = from;
   if (filePath.startsWith("{file:") && filePath.endsWith("}")) {
     filePath = filePath.slice(6, -1);
   }
   if (filePath.startsWith("~/")) {
-    return resolve22(homedir26(), filePath.slice(2));
+    return resolve22(homedir27(), filePath.slice(2));
   }
   if (isAbsolute13(filePath)) {
     return filePath;
@@ -94416,7 +94515,7 @@ function isDisabledSkillName(name, disabledSkills) {
 init_src();
 var import_picomatch2 = __toESM(require_picomatch2(), 1);
 import * as fs20 from "fs/promises";
-import { homedir as homedir27 } from "os";
+import { homedir as homedir28 } from "os";
 import { dirname as dirname27, extname as extname2, isAbsolute as isAbsolute14, join as join90, relative as relative12 } from "path";
 var MAX_RECURSIVE_DEPTH = 10;
 function isHttpUrl(path17) {
@@ -94424,10 +94523,10 @@ function isHttpUrl(path17) {
 }
 function toAbsolutePath(path17, configDir) {
   if (path17 === "~") {
-    return homedir27();
+    return homedir28();
   }
   if (path17.startsWith("~/")) {
-    return join90(homedir27(), path17.slice(2));
+    return join90(homedir28(), path17.slice(2));
   }
   if (isAbsolute14(path17)) {
     return path17;
@@ -100754,7 +100853,7 @@ function buildRetryGuidance(errorInfo) {
   if (!pattern) {
     return `[task ERROR] Fix the error and retry with correct parameters.`;
   }
-  let guidance = `
+  let guidance2 = `
  [task CALL FAILED - IMMEDIATE RETRY REQUIRED]
 
  **Error Type**: ${errorInfo.errorType}
@@ -100762,11 +100861,11 @@ function buildRetryGuidance(errorInfo) {
  `;
   const availableList = extractAvailableList(errorInfo.originalOutput);
   if (availableList) {
-    guidance += `
+    guidance2 += `
 **Available Options**: ${availableList}
 `;
   }
-  guidance += `
+  guidance2 += `
  **Action**: Retry task NOW with corrected parameters.
 
  Example of CORRECT call:
@@ -100780,7 +100879,7 @@ function buildRetryGuidance(errorInfo) {
  )
  \`\`\`
  `;
-  return guidance;
+  return guidance2;
 }
 // packages/omo-opencode/src/hooks/delegate-task-retry/hook.ts
 function createDelegateTaskRetryHook(_ctx) {
@@ -100792,9 +100891,9 @@ function createDelegateTaskRetryHook(_ctx) {
         return;
       const errorInfo = detectDelegateTaskError(output.output);
       if (errorInfo) {
-        const guidance = buildRetryGuidance(errorInfo);
+        const guidance2 = buildRetryGuidance(errorInfo);
         output.output += `
-${guidance}`;
+${guidance2}`;
       }
     }
   };
@@ -110815,18 +110914,18 @@ import { existsSync as existsSync95, readdirSync as readdirSync23 } from "fs";
 import { join as join108 } from "path";
 
 // packages/claude-code-compat-core/src/shared/claude-config-dir.ts
-import { homedir as homedir28 } from "os";
+import { homedir as homedir29 } from "os";
 import { join as join103 } from "path";
 function getClaudeConfigDir3() {
   const envConfigDir = process.env.CLAUDE_CONFIG_DIR;
   if (envConfigDir) {
     return envConfigDir;
   }
-  return join103(process.env.HOME || process.env.USERPROFILE || homedir28(), ".claude");
+  return join103(process.env.HOME || process.env.USERPROFILE || homedir29(), ".claude");
 }
 // packages/claude-code-compat-core/src/shared/opencode-config-dir.ts
 import { existsSync as existsSync91, realpathSync as realpathSync15 } from "fs";
-import { homedir as homedir29 } from "os";
+import { homedir as homedir30 } from "os";
 import { join as join104, posix as posix7, resolve as resolve33, win32 as win3210 } from "path";
 var TAURI_APP_IDENTIFIER3 = "ai.opencode.desktop";
 var TAURI_APP_IDENTIFIER_DEV3 = "ai.opencode.desktop.dev";
@@ -110839,14 +110938,14 @@ function getTauriConfigDir3(identifier) {
   const platform2 = process.platform;
   switch (platform2) {
     case "darwin":
-      return join104(homedir29(), "Library", "Application Support", identifier);
+      return join104(homedir30(), "Library", "Application Support", identifier);
     case "win32": {
-      const appData = process.env.APPDATA || join104(homedir29(), "AppData", "Roaming");
+      const appData = process.env.APPDATA || join104(homedir30(), "AppData", "Roaming");
       return win3210.join(appData, identifier);
     }
     case "linux":
     default: {
-      const xdgConfig = process.env.XDG_CONFIG_HOME || join104(homedir29(), ".config");
+      const xdgConfig = process.env.XDG_CONFIG_HOME || join104(homedir30(), ".config");
       return join104(xdgConfig, identifier);
     }
   }
@@ -110890,7 +110989,7 @@ function getWslLinuxHomeDir3(windowsConfigRoot) {
 function getCliDefaultConfigDir3() {
   const envXdgConfig = process.env.XDG_CONFIG_HOME?.trim();
   const shouldIgnoreWindowsXdg = envXdgConfig !== undefined && envXdgConfig.length > 0 && isWslEnvironment3() && isWindowsUserConfigRoot3(envXdgConfig);
-  const xdgConfig = shouldIgnoreWindowsXdg ? posix7.join(getWslLinuxHomeDir3(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join104(homedir29(), ".config");
+  const xdgConfig = shouldIgnoreWindowsXdg ? posix7.join(getWslLinuxHomeDir3(envXdgConfig) ?? "/home", ".config") : envXdgConfig || join104(homedir30(), ".config");
   const configDir = isWslEnvironment3() ? posix7.join(xdgConfig, "opencode") : join104(xdgConfig, "opencode");
   return resolveConfigPath3(configDir);
 }
@@ -110935,11 +111034,11 @@ function getOpenCodeConfigDir3(options) {
 // packages/claude-code-compat-core/src/shared/jsonc-parser.ts
 init_src();
 // packages/claude-code-compat-core/src/shared/resolve-agent-definition-paths.ts
-import { homedir as homedir30 } from "os";
+import { homedir as homedir31 } from "os";
 import { isAbsolute as isAbsolute18, join as join105, resolve as resolve34 } from "path";
 function resolveAgentDefinitionPaths2(paths, baseDir, containmentDir) {
   return paths.flatMap((p) => {
-    const expanded = p.startsWith("~/") ? join105(homedir30(), p.slice(2)) : p;
+    const expanded = p.startsWith("~/") ? join105(homedir31(), p.slice(2)) : p;
     const resolved = isAbsolute18(expanded) ? expanded : resolve34(baseDir, expanded);
     if (containmentDir !== null && !isWithinProject(resolved, containmentDir)) {
       log4(`agent_definitions path rejected (outside project boundary): ${p} -> ${resolved}`);
@@ -111470,9 +111569,7 @@ Description: ${task.description}
 Agent: ${task.agent} (subagent)
 Status: ${task.status}
 
-System notifies on completion. Use \`background_output\` with task_id="${task.id}" to check.
-
-Do NOT call background_output now. Wait for <system-reminder> notification first.`;
+Do NOT call background_output now. Wait for <system-reminder> notification first. The system will deliver the result when the task completes; you do not need to poll for it.`;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     return `Failed to launch background agent task: ${message}`;
@@ -113722,9 +113819,7 @@ Agent: ${task.agent}
 Status: ${task.status}
 
 Agent continues with full previous context preserved.
-System notifies on completion. Use \`background_output\` with task_id="${backgroundTaskId}" to check.
-
-Do NOT call background_output now. Wait for <system-reminder> notification first.
+Do NOT call background_output now. Wait for <system-reminder> notification first. The system will deliver the result when the task completes; you do not need to poll for it.
 
 ${buildTaskMetadataBlock({
       sessionId,
@@ -114738,9 +114833,7 @@ Description: ${task.description}
 Agent: ${task.agent}${args.category ? ` (category: ${args.category})` : ""}
 Status: ${task.status}
 
-System notifies on completion. Use \`background_output\` with task_id="${task.id}" to check.
-
-Do NOT call background_output now. Wait for <system-reminder> notification first.${taskMetadataBlock}`;
+Do NOT call background_output now. Wait for <system-reminder> notification first. The system will deliver the result when the task completes; you do not need to poll for it.${taskMetadataBlock}`;
   } catch (error) {
     return formatDetailedError(error, {
       operation: "Launch background task",
@@ -125004,7 +125097,7 @@ import { basename as basename22, dirname as dirname39, join as join120 } from "p
 
 // packages/mcp-client-core/src/config-dir.ts
 import { existsSync as existsSync100, realpathSync as realpathSync17 } from "fs";
-import { homedir as homedir31 } from "os";
+import { homedir as homedir32 } from "os";
 import { join as join118, resolve as resolve36 } from "path";
 function resolveConfigPath4(pathValue) {
   const resolvedPath = resolve36(pathValue);
@@ -125023,7 +125116,7 @@ function getOpenCodeCliConfigDir(env2 = process.env) {
   if (customConfigDir) {
     return resolveConfigPath4(customConfigDir);
   }
-  const xdgConfigDir = env2["XDG_CONFIG_HOME"]?.trim() || join118(homedir31(), ".config");
+  const xdgConfigDir = env2["XDG_CONFIG_HOME"]?.trim() || join118(homedir32(), ".config");
   return resolveConfigPath4(join118(xdgConfigDir, "opencode"));
 }
 
@@ -130576,10 +130669,10 @@ import { dirname as dirname40 } from "path";
 // packages/omo-opencode/src/features/tui-sidebar/mirror-path.ts
 import { createHash as createHash8 } from "crypto";
 import { realpathSync as realpathSync18 } from "fs";
-import { homedir as homedir32 } from "os";
+import { homedir as homedir33 } from "os";
 import { join as join121, resolve as resolve37 } from "path";
 function mirrorStorageDir() {
-  return join121(process.env.XDG_DATA_HOME ?? join121(homedir32(), ".local", "share"), "opencode", "storage", "oh-my-openagent", MIRROR_DIR_NAME);
+  return join121(process.env.XDG_DATA_HOME ?? join121(homedir33(), ".local", "share"), "opencode", "storage", "oh-my-openagent", MIRROR_DIR_NAME);
 }
 function canonicalProjectDir(projectDir) {
   try {
@@ -133454,11 +133547,11 @@ import {
 
 // packages/openclaw-core/src/reply-listener-paths.ts
 import { existsSync as existsSync103, mkdirSync as mkdirSync22 } from "fs";
-import { homedir as homedir33 } from "os";
+import { homedir as homedir34 } from "os";
 import { join as join123 } from "path";
 var REPLY_LISTENER_SECURE_FILE_MODE = 384;
 function resolveReplyListenerHomeDir() {
-  return process.env.HOME ?? process.env.USERPROFILE ?? homedir33();
+  return process.env.HOME ?? process.env.USERPROFILE ?? homedir34();
 }
 function getReplyListenerStateDir() {
   return join123(resolveReplyListenerHomeDir(), ".omo", "openclaw", "state");
@@ -134661,7 +134754,7 @@ async function createRuntimeSkillSourceServer(options, runtimeEnv = runtime6) {
 // packages/claude-code-compat-core/src/features/claude-code-mcp-loader/loader.ts
 import { existsSync as existsSync108, readFileSync as readFileSync75 } from "fs";
 import { join as join126 } from "path";
-import { homedir as homedir34 } from "os";
+import { homedir as homedir35 } from "os";
 function getMcpConfigPaths() {
   const claudeConfigDir = getClaudeConfigDir3();
   const homeDir = getHomeDir();
@@ -134674,7 +134767,7 @@ function getMcpConfigPaths() {
   ];
 }
 function getHomeDir() {
-  return process.env.HOME || process.env.USERPROFILE || homedir34();
+  return process.env.HOME || process.env.USERPROFILE || homedir35();
 }
 async function loadMcpConfigFile(filePath) {
   if (!existsSync108(filePath)) {
@@ -141603,14 +141696,14 @@ function createHephaestusAgent(model, availableAgents, availableToolNames, avail
 createHephaestusAgent.mode = MODE9;
 // packages/omo-opencode/src/agents/builtin-agents/resolve-file-uri.ts
 import { existsSync as existsSync109, readFileSync as readFileSync76 } from "fs";
-import { homedir as homedir35 } from "os";
+import { homedir as homedir36 } from "os";
 import { isAbsolute as isAbsolute20, join as join127, resolve as resolve38 } from "path";
 init_logger2();
 var ALLOWED_HOME_SUBDIRS = [
-  join127(homedir35(), ".config", "opencode"),
-  join127(homedir35(), ".config", "oh-my-openagent"),
-  join127(homedir35(), ".omo"),
-  join127(homedir35(), ".opencode")
+  join127(homedir36(), ".config", "opencode"),
+  join127(homedir36(), ".config", "oh-my-openagent"),
+  join127(homedir36(), ".omo"),
+  join127(homedir36(), ".opencode")
 ];
 function isWithinAllowedPaths(filePath, projectRoot) {
   if (isWithinProject(filePath, projectRoot))
@@ -141628,7 +141721,7 @@ function resolvePromptAppend(promptAppend, configDir) {
   let filePath;
   try {
     const decoded = decodeURIComponent(encoded);
-    const expanded = decoded.startsWith("~/") ? decoded.replace(/^~\//, `${homedir35()}/`) : decoded;
+    const expanded = decoded.startsWith("~/") ? decoded.replace(/^~\//, `${homedir36()}/`) : decoded;
     filePath = isAbsolute20(expanded) ? expanded : resolve38(configDir ?? process.cwd(), expanded);
   } catch (error) {
     if (!(error instanceof Error)) {
@@ -149953,6 +150046,7 @@ function createToolDefinitionHandler(args) {
 }
 
 // packages/omo-opencode/src/plugin/tool-execute-after.ts
+init_src();
 init_logger2();
 var VERIFICATION_ATTEMPT_PATTERN = /<ulw_verification_attempt_id>(.*?)<\/ulw_verification_attempt_id>/i;
 var METADATA_LINKED_TOOLS = new Set([
@@ -149978,12 +150072,25 @@ function getPluginDirectory(ctx) {
 function expectsRecoverableMetadata(tool3) {
   return METADATA_LINKED_TOOLS.has(tool3);
 }
+function appendCodegraphInitGuidance(input, output, cwd) {
+  const guidance2 = buildCodegraphInitGuidanceForToolResult({
+    cwd: cwd ?? undefined,
+    toolName: input.tool,
+    toolOutput: output.output
+  });
+  if (guidance2 === null || output.output.includes(guidance2))
+    return;
+  output.output = `${output.output}
+
+${guidance2}`;
+}
 function createToolExecuteAfterHandler3(args) {
   const { ctx, hooks } = args;
   const log8 = args.log ?? log2;
   return async (input, output) => {
     if (!output)
       return;
+    appendCodegraphInitGuidance(input, output, getPluginDirectory(ctx));
     const hookInput = {
       tool: input.tool,
       sessionID: input.sessionID,
@@ -150379,7 +150486,7 @@ function createPluginInterface(args) {
 
 // packages/omo-opencode/src/plugin-config/layered-config-loader.ts
 import * as fs25 from "fs";
-import { homedir as homedir36 } from "os";
+import { homedir as homedir37 } from "os";
 import * as path27 from "path";
 
 // packages/omo-opencode/src/config/schema/agent-names.ts
@@ -151221,7 +151328,7 @@ function loadConfigFromPath2(configPath, _ctx) {
 
 // packages/omo-opencode/src/plugin-config/layered-config-loader.ts
 function resolveHomeDirectory() {
-  return process.env.HOME ?? process.env.USERPROFILE ?? homedir36();
+  return process.env.HOME ?? process.env.USERPROFILE ?? homedir37();
 }
 function resolveConfigPathAfterLegacyMigration(detectedPath) {
   if (!path27.basename(detectedPath).startsWith(LEGACY_CONFIG_BASENAME)) {