Method stat

packages/kaos/src/ssh.ts:584–608

(path: string, options?: { followSymlinks?: boolean })

  }

  async stat(path: string, options?: { followSymlinks?: boolean }): Promise<StatResult> {
    const resolved = this._resolvePath(path);
    const followSymlinks = options?.followSymlinks ?? true;
    // sftpStat / sftpLstat already wrap errors via mapSftpError.
    const st = followSymlinks
      ? await sftpStat(this._sftp, resolved)
      : await sftpLstat(this._sftp, resolved);

    return {
      stMode: buildStMode(st),
      // SFTP does not provide inode
      stIno: 0,
      // SFTP does not provide device
      stDev: 0,
      // ssh2 Stats does not expose nlink
      stNlink: 0,
      stUid: st.uid,
      stGid: st.gid,
      stSize: st.size,
      stAtime: st.atime,
      stMtime: st.mtime,
      // SFTP v3 has no ctime, fallback to mtime
      stCtime: st.mtime,
    };
  }

  async *iterdir(path: string): AsyncGenerator<string> {
    const resolved = this._resolvePath(path);