/**
 * 邮件寻址里的工作目录（三维地址 name@path.session 的 path 位）。
 *
 * 这个模块存在的理由是一次真实故障：插件建会话时用的 cwd 是自己拼的
 * `~/.dsh/mail-sessions/mail-<uuid>` —— 每封邮件一个全新的空目录。
 * DSH 与 opencode 都按 cwd 给会话分组，于是所有邮件会话既不属于任何项目、
 * 彼此也不同组，界面上全落进「未分组」。
 *
 * path 位本来就是「希望它在哪儿干活」，插件只需照用。
 */

import { existsSync, mkdirSync, statSync } from 'node:fs';
import { homedir } from 'node:os';
import { isAbsolute, join, resolve } from 'node:path';

/**
 * 校验寻址里的工作目录，不可用时返回调用方给的兜底。
 *
 * 决策顺序：
 *   1. path 位是一个已存在的目录 → 直接用它（同 path 的多封邮件天然同组）
 *   2. path 位非空但目录不存在 → **不创建**，返回兜底
 *   3. path 位为空（地址写成 `dsh` 而不带 `@/path`）→ 兜底
 *
 * 为什么不给不存在的 path 建目录：那等于让一个笔误（`/home/porgram/x`）
 * 在磁盘上落下一个真目录，而 Agent 会在里面一无所获地干活 ——
 * 用户看到会话建起来了却什么都做不了，比明确落到兜底目录更难排查。
 *
 * 为什么拒绝相对路径：cwd 的相对基准是 harness 进程的启动目录，
 * 那是个与邮件语义无关的量（systemd 下通常是 `/`）。
 *
 * 兜底由调用方给，因为各平台的兜底不同：opencode 有插件启动时的 directory
 * 可用，DSH 没有、只能落到 `~/.dsh/mail-sessions/<会话>`（见 mailSessionFallback）。
 *
 * @param {string} workspace 事件里的 to_workspace
 * @param {string} fallback 不可用时的兜底目录（可为空串 = 交给平台自己决定）
 * @returns {{cwd: string, grouped: boolean}} grouped 为真表示落在了寻址指定的目录里
 */
export function resolveWorkspaceCwd(workspace, fallback) {
  const raw = typeof workspace === 'string' ? workspace.trim() : '';
  const fb = typeof fallback === 'string' ? fallback : '';

  if (!raw || !isAbsolute(raw)) return { cwd: fb, grouped: false };

  const abs = resolve(raw);
  try {
    if (existsSync(abs) && statSync(abs).isDirectory()) {
      return { cwd: abs, grouped: true };
    }
  } catch {
    // 权限不足等：当作不可用
  }
  return { cwd: fb, grouped: false };
}

/**
 * 没有天然兜底的平台（DSH）用这个：`~/.dsh/mail-sessions/<会话 id>`。
 * @param {string} sessionKey 会话标识
 * @returns {string}
 */
export function mailSessionFallback(sessionKey) {
  return join(homedir(), '.dsh', 'mail-sessions', String(sessionKey || 'default'));
}

/**
 * 确保兜底目录存在。寻址指定的目录本来就存在（否则不会被选中），
 * 只有兜底目录需要现建。
 * @param {string} cwd resolveWorkspaceCwd 的结果
 * @param {boolean} grouped 是否落在寻址指定的目录里
 */
export function ensureCwd(cwd, grouped) {
  if (grouped || !cwd) return;
  try {
    mkdirSync(cwd, { recursive: true });
  } catch {
    // 建不出来就让 harness 自己报错，这里不该吞掉真实原因
  }
}