import { isAbsolute, relative, sep } from 'node:path' export function userStateDir(home = process.env.HOME || process.env.USERPROFILE || ''): string { if (!home) { throw new Error('Cannot resolve user home directory') } return `${home.replace(/\\/g, '/')}/.skillhub` } export function joinPath(...parts: string[]): string { return parts.join('/').replace(/\/+/g, '/') } export async function ensureDir(dir: string): Promise { const { mkdir } = await import('node:fs/promises') await mkdir(dir, { recursive: true }) } export async function pathExists(path: string): Promise { const { access } = await import('node:fs/promises') try { await access(path) return true } catch { return false } } export async function directoryExists(path: string): Promise { const { stat } = await import('node:fs/promises') try { return (await stat(path)).isDirectory() } catch { return false } } export async function canonicalizeExistingPath(path: string): Promise { const { realpath } = await import('node:fs/promises') try { return await realpath(path) } catch { return path } } export async function applyCredentialPermissions(path: string): Promise { if (process.platform === 'win32') return const { chmod } = await import('node:fs/promises') await chmod(path, 0o600) } /** Inputs must be canonical absolute paths. Compare segments, not string prefixes. */ export function pathsOverlap(left: string, right: string): boolean { const contains = (parent: string, child: string) => { const rel = relative(parent, child) return rel === '' || (!isAbsolute(rel) && rel !== '..' && !rel.startsWith(`..${sep}`)) } return contains(left, right) || contains(right, left) }