fix: normalize ~ in path config

src/config/normalize-paths.ts

@@ -0,0 +1,57 @@
+import { resolveUserPath } from "../utils.js";
+import type { ClawdbotConfig } from "./types.js";
+
+const PATH_VALUE_RE = /^~(?=$|[\\/])/;
+
+const PATH_KEY_RE = /(dir|path|paths|file|root|workspace)$/i;
+const PATH_LIST_KEYS = new Set(["paths"]);
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function normalizeStringValue(key: string | undefined, value: string): string {
+  if (!PATH_VALUE_RE.test(value.trim())) return value;
+  if (!key) return value;
+  if (PATH_KEY_RE.test(key) || PATH_LIST_KEYS.has(key)) {
+    return resolveUserPath(value);
+  }
+  return value;
+}
+
+function normalizeAny(key: string | undefined, value: unknown): unknown {
+  if (typeof value === "string") return normalizeStringValue(key, value);
+
+  if (Array.isArray(value)) {
+    const normalizeChildren = Boolean(key && PATH_LIST_KEYS.has(key));
+    return value.map((entry) => {
+      if (typeof entry === "string") {
+        return normalizeChildren ? normalizeStringValue(key, entry) : entry;
+      }
+      if (Array.isArray(entry)) return normalizeAny(undefined, entry);
+      if (isPlainObject(entry)) return normalizeAny(undefined, entry);
+      return entry;
+    });
+  }
+
+  if (!isPlainObject(value)) return value;
+
+  for (const [childKey, childValue] of Object.entries(value)) {
+    const next = normalizeAny(childKey, childValue);
+    if (next !== childValue) value[childKey] = next;
+  }
+
+  return value;
+}
+
+/**
+ * Normalize "~" paths in path-ish config fields.
+ *
+ * Goal: accept `~/...` consistently across config file + env overrides, while
+ * keeping the surface area small and predictable.
+ */
+export function normalizeConfigPaths(cfg: ClawdbotConfig): ClawdbotConfig {
+  if (!cfg || typeof cfg !== "object") return cfg;
+  normalizeAny(undefined, cfg);
+  return cfg;
+}