Method chdir

packages/kaos/src/ssh.ts:565–582

(path: string)

  // ── Directory operations (async) ───────────────────────────────────

  async chdir(path: string): Promise<void> {
    let target: string;
    if (isAbsolute(path)) {
      target = path;
    } else {
      target = resolve(this._cwd, path);
    }
    // Resolve to the real path via SFTP
    const resolved = await sftpRealpath(this._sftp, target);
    // Verify the resolved target is actually a directory. Without this
    // guard, `realpath` happily returns file paths, causing later relative
    // reads/writes/execs to treat a regular file as a working directory.
    const attrs = await sftpStat(this._sftp, resolved);
    if (!attrs.isDirectory()) {
      throw new KaosValueError(`${resolved} is not a directory`);
    }
    this._cwd = resolved;
  }

  async stat(path: string, options?: { followSymlinks?: boolean }): Promise<StatResult> {
    const resolved = this._resolvePath(path);