refactor: wave 2 - split atlas, auto-update-checker, session-recovery, todo-enforcer, background-task hooks

- Extract atlas/ into 15 focused modules (hook, event handler, tool policies, types, etc.)
- Split auto-update-checker into checker/ and hook/ subdirectories with single-purpose files
- Decompose session-recovery into separate recovery strategy files per error type
- Extract todo-continuation-enforcer from monolith to directory with dedicated modules
- Split background-task/tools.ts into individual tool creator files
- Extract command-executor, tmux-utils into focused sub-modules
- Split config/schema.ts into domain-specific schema files
- Decompose cli/config-manager.ts into focused modules
- Rollback skill-mcp-manager, model-availability, index.ts splits that broke tests
- Fix all import path depths for moved files (../../ -> ../../../)
- Add explicit type annotations to resolve TS7006 implicit any errors

Typecheck: 0 errors
Tests: 2359 pass, 5 fail (all pre-existing)

src/hooks/auto-update-checker/hook/background-update-check.ts

@@ -0,0 +1,79 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import { runBunInstall } from "../../../cli/config-manager"
+import { log } from "../../../shared/logger"
+import { invalidatePackage } from "../cache"
+import { PACKAGE_NAME } from "../constants"
+import { extractChannel } from "../version-channel"
+import { findPluginEntry, getCachedVersion, getLatestVersion, updatePinnedVersion } from "../checker"
+import { showAutoUpdatedToast, showUpdateAvailableToast } from "./update-toasts"
+
+async function runBunInstallSafe(): Promise<boolean> {
+  try {
+    return await runBunInstall()
+  } catch (err) {
+    const errorMessage = err instanceof Error ? err.message : String(err)
+    log("[auto-update-checker] bun install error:", errorMessage)
+    return false
+  }
+}
+
+export async function runBackgroundUpdateCheck(
+  ctx: PluginInput,
+  autoUpdate: boolean,
+  getToastMessage: (isUpdate: boolean, latestVersion?: string) => string
+): Promise<void> {
+  const pluginInfo = findPluginEntry(ctx.directory)
+  if (!pluginInfo) {
+    log("[auto-update-checker] Plugin not found in config")
+    return
+  }
+
+  const cachedVersion = getCachedVersion()
+  const currentVersion = cachedVersion ?? pluginInfo.pinnedVersion
+  if (!currentVersion) {
+    log("[auto-update-checker] No version found (cached or pinned)")
+    return
+  }
+
+  const channel = extractChannel(pluginInfo.pinnedVersion ?? currentVersion)
+  const latestVersion = await getLatestVersion(channel)
+  if (!latestVersion) {
+    log("[auto-update-checker] Failed to fetch latest version for channel:", channel)
+    return
+  }
+
+  if (currentVersion === latestVersion) {
+    log("[auto-update-checker] Already on latest version for channel:", channel)
+    return
+  }
+
+  log(`[auto-update-checker] Update available (${channel}): ${currentVersion} → ${latestVersion}`)
+
+  if (!autoUpdate) {
+    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage)
+    log("[auto-update-checker] Auto-update disabled, notification only")
+    return
+  }
+
+  if (pluginInfo.isPinned) {
+    const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion)
+    if (!updated) {
+      await showUpdateAvailableToast(ctx, latestVersion, getToastMessage)
+      log("[auto-update-checker] Failed to update pinned version in config")
+      return
+    }
+    log(`[auto-update-checker] Config updated: ${pluginInfo.entry} → ${PACKAGE_NAME}@${latestVersion}`)
+  }
+
+  invalidatePackage(PACKAGE_NAME)
+
+  const installSuccess = await runBunInstallSafe()
+
+  if (installSuccess) {
+    await showAutoUpdatedToast(ctx, currentVersion, latestVersion)
+    log(`[auto-update-checker] Update installed: ${currentVersion} → ${latestVersion}`)
+  } else {
+    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage)
+    log("[auto-update-checker] bun install failed; update not installed (falling back to notification-only)")
+  }
+}

src/hooks/auto-update-checker/hook/config-errors-toast.ts

@@ -0,0 +1,23 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import { getConfigLoadErrors, clearConfigLoadErrors } from "../../../shared/config-errors"
+import { log } from "../../../shared/logger"
+
+export async function showConfigErrorsIfAny(ctx: PluginInput): Promise<void> {
+  const errors = getConfigLoadErrors()
+  if (errors.length === 0) return
+
+  const errorMessages = errors.map((error: { path: string; error: string }) => `${error.path}: ${error.error}`).join("\n")
+  await ctx.client.tui
+    .showToast({
+      body: {
+        title: "Config Load Error",
+        message: `Failed to load config:\n${errorMessages}`,
+        variant: "error" as const,
+        duration: 10000,
+      },
+    })
+    .catch(() => {})
+
+  log(`[auto-update-checker] Config load errors shown: ${errors.length} error(s)`) 
+  clearConfigLoadErrors()
+}

src/hooks/auto-update-checker/hook/connected-providers-status.ts

@@ -0,0 +1,29 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import {
+  hasConnectedProvidersCache,
+  updateConnectedProvidersCache,
+} from "../../../shared/connected-providers-cache"
+import { log } from "../../../shared/logger"
+
+export async function updateAndShowConnectedProvidersCacheStatus(ctx: PluginInput): Promise<void> {
+  const hadCache = hasConnectedProvidersCache()
+
+  updateConnectedProvidersCache(ctx.client).catch(() => {})
+
+  if (!hadCache) {
+    await ctx.client.tui
+      .showToast({
+        body: {
+          title: "Connected Providers Cache",
+          message: "Building provider cache for first time. Restart OpenCode for full model filtering.",
+          variant: "info" as const,
+          duration: 8000,
+        },
+      })
+      .catch(() => {})
+
+    log("[auto-update-checker] Connected providers cache toast shown (first run)")
+  } else {
+    log("[auto-update-checker] Connected providers cache exists, updating in background")
+  }
+}

src/hooks/auto-update-checker/hook/model-cache-warning.ts

@@ -0,0 +1,21 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import { isModelCacheAvailable } from "../../../shared/model-availability"
+import { log } from "../../../shared/logger"
+
+export async function showModelCacheWarningIfNeeded(ctx: PluginInput): Promise<void> {
+  if (isModelCacheAvailable()) return
+
+  await ctx.client.tui
+    .showToast({
+      body: {
+        title: "Model Cache Not Found",
+        message:
+          "Run 'opencode models --refresh' or restart OpenCode to populate the models cache for optimal agent model selection.",
+        variant: "warning" as const,
+        duration: 10000,
+      },
+    })
+    .catch(() => {})
+
+  log("[auto-update-checker] Model cache warning shown")
+}

src/hooks/auto-update-checker/hook/spinner-toast.ts

@@ -0,0 +1,25 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+
+const SISYPHUS_SPINNER = ["·", "•", "●", "○", "◌", "◦", " "]
+
+export async function showSpinnerToast(ctx: PluginInput, version: string, message: string): Promise<void> {
+  const totalDuration = 5000
+  const frameInterval = 100
+  const totalFrames = Math.floor(totalDuration / frameInterval)
+
+  for (let i = 0; i < totalFrames; i++) {
+    const spinner = SISYPHUS_SPINNER[i % SISYPHUS_SPINNER.length]
+    await ctx.client.tui
+      .showToast({
+        body: {
+          title: `${spinner} OhMyOpenCode ${version}`,
+          message,
+          variant: "info" as const,
+          duration: frameInterval + 50,
+        },
+      })
+      .catch(() => {})
+
+    await new Promise((resolve) => setTimeout(resolve, frameInterval))
+  }
+}

src/hooks/auto-update-checker/hook/startup-toasts.ts

@@ -0,0 +1,22 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import { log } from "../../../shared/logger"
+import { showSpinnerToast } from "./spinner-toast"
+
+export async function showVersionToast(ctx: PluginInput, version: string | null, message: string): Promise<void> {
+  const displayVersion = version ?? "unknown"
+  await showSpinnerToast(ctx, displayVersion, message)
+  log(`[auto-update-checker] Startup toast shown: v${displayVersion}`)
+}
+
+export async function showLocalDevToast(
+  ctx: PluginInput,
+  version: string | null,
+  isSisyphusEnabled: boolean
+): Promise<void> {
+  const displayVersion = version ?? "dev"
+  const message = isSisyphusEnabled
+    ? "Sisyphus running in local development mode."
+    : "Running in local development mode. oMoMoMo..."
+  await showSpinnerToast(ctx, `${displayVersion} (dev)`, message)
+  log(`[auto-update-checker] Local dev toast shown: v${displayVersion}`)
+}

src/hooks/auto-update-checker/hook/update-toasts.ts

@@ -0,0 +1,34 @@
+import type { PluginInput } from "@opencode-ai/plugin"
+import { log } from "../../../shared/logger"
+
+export async function showUpdateAvailableToast(
+  ctx: PluginInput,
+  latestVersion: string,
+  getToastMessage: (isUpdate: boolean, latestVersion?: string) => string
+): Promise<void> {
+  await ctx.client.tui
+    .showToast({
+      body: {
+        title: `OhMyOpenCode ${latestVersion}`,
+        message: getToastMessage(true, latestVersion),
+        variant: "info" as const,
+        duration: 8000,
+      },
+    })
+    .catch(() => {})
+  log(`[auto-update-checker] Update available toast shown: v${latestVersion}`)
+}
+
+export async function showAutoUpdatedToast(ctx: PluginInput, oldVersion: string, newVersion: string): Promise<void> {
+  await ctx.client.tui
+    .showToast({
+      body: {
+        title: "OhMyOpenCode Updated!",
+        message: `v${oldVersion} → v${newVersion}\nRestart OpenCode to apply.`,
+        variant: "success" as const,
+        duration: 8000,
+      },
+    })
+    .catch(() => {})
+  log(`[auto-update-checker] Auto-updated toast shown: v${oldVersion} → v${newVersion}`)
+}