chore(git): merge from master

Author: KSXGitHub

.devcontainer/devcontainer.json

@@ -0,0 +1,14 @@
+{
+  "name": "parallel-disk-usage (Rust only)",
+  "image": "mcr.microsoft.com/devcontainers/rust:1",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer",
+        "timonwong.shellcheck",
+        "mkhl.shfmt"
+      ]
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/post-create.sh"
+}

.devcontainer/full/devcontainer.json

@@ -0,0 +1,26 @@
+{
+  "name": "parallel-disk-usage (full)",
+  "image": "mcr.microsoft.com/devcontainers/rust:1",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "lts",
+      "nodeGypDependencies": true
+    },
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.12",
+      "installTools": true
+    },
+    "ghcr.io/devcontainers-contrib/features/shellcheck:1": {},
+    "ghcr.io/devcontainers-contrib/features/shfmt:1": {}
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer",
+        "timonwong.shellcheck",
+        "mkhl.shfmt"
+      ]
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/full/post-create.sh"
+}

.devcontainer/full/post-create.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "Installing Python dependencies..." >&2
+python3 -m pip install --user toml
+
+echo "Installing pnpm and project Node dependencies..." >&2
+npm install -g pnpm@7.9.0
+(cd ci/github-actions && pnpm install --frozen-lockfile)
+
+bash "$(dirname "$0")/../install-rust-toolchain.sh"
+bash "$(dirname "$0")/../install-hyperfine.sh"

.devcontainer/install-hyperfine.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Shared helper: install hyperfine binary from GitHub releases into ~/.local/bin
+set -euo pipefail
+
+arch="$(uname -m)"
+case "$arch" in
+  x86_64)  hyperfine_target="x86_64-unknown-linux-musl" ;;
+  aarch64) hyperfine_target="aarch64-unknown-linux-musl" ;;
+  *)
+    echo "ERROR: Unsupported architecture for hyperfine prebuilt binary: $arch" >&2
+    exit 1
+    ;;
+esac
+
+mkdir -p "$HOME/.local/bin"
+
+echo "Installing hyperfine from GitHub release..." >&2
+hyperfine_version="1.20.0"
+hyperfine_archive="hyperfine-v${hyperfine_version}-${hyperfine_target}"
+hyperfine_url="https://github.com/sharkdp/hyperfine/releases/download/v${hyperfine_version}/${hyperfine_archive}.tar.gz"
+curl -fsSL "$hyperfine_url" | tar -xz --strip-components=1 -C "$HOME/.local/bin" "${hyperfine_archive}/hyperfine"

.devcontainer/install-rust-toolchain.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+echo "Installing Rust toolchain from rust-toolchain..." >&2
+rustup toolchain install "$(<"$REPO_ROOT/rust-toolchain")"
+rustup component add clippy rustfmt rust-analyzer

.devcontainer/post-create.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+mkdir -p "$HOME/.local/bin"
+
+bash "$(dirname "$0")/install-rust-toolchain.sh"
+bash "$(dirname "$0")/install-hyperfine.sh"
+
+arch="$(uname -m)"
+
+echo "Installing shellcheck from GitHub release..." >&2
+shellcheck_version="0.11.0"
+case "$arch" in
+  x86_64)  shellcheck_arch="linux.x86_64" ;;
+  aarch64) shellcheck_arch="linux.aarch64" ;;
+  *)
+    echo "ERROR: Unsupported architecture for shellcheck prebuilt binary: $arch" >&2
+    exit 1
+    ;;
+esac
+shellcheck_archive="shellcheck-v${shellcheck_version}.${shellcheck_arch}"
+shellcheck_url="https://github.com/koalaman/shellcheck/releases/download/v${shellcheck_version}/${shellcheck_archive}.tar.gz"
+curl -fsSL "$shellcheck_url" | tar -xz --strip-components=1 -C "$HOME/.local/bin" "shellcheck-v${shellcheck_version}/shellcheck"
+
+echo "Installing shfmt from GitHub release..." >&2
+shfmt_version="3.13.0"
+case "$arch" in
+  x86_64)  shfmt_arch="linux_amd64" ;;
+  aarch64) shfmt_arch="linux_arm64" ;;
+  *)
+    echo "ERROR: Unsupported architecture for shfmt prebuilt binary: $arch" >&2
+    exit 1
+    ;;
+esac
+shfmt_url="https://github.com/mvdan/sh/releases/download/v${shfmt_version}/shfmt_v${shfmt_version}_${shfmt_arch}"
+curl -fsSL "$shfmt_url" -o "$HOME/.local/bin/shfmt"
+chmod +x "$HOME/.local/bin/shfmt"

.github/copilot-instructions.md

@@ -0,0 +1,19 @@
+# AI Instructions
+
+Read and follow the CONTRIBUTING.md file in this repository for all code style conventions, commit message format, and development guidelines.
+
+## Quick Reference
+
+- Commit format: Conventional Commits — `type(scope): lowercase description`
+- Version releases are the only exception: just the version number (e.g. `0.21.1`)
+- Prefer merged imports
+- Use descriptive generic names (`Size`, `Report`), not single letters
+- Use descriptive variable and closure parameter names by default — single letters are only allowed in: conventional names (`n` for count, `f` for formatter), comparison closures (`|a, b|`), trivial single-expression closures, fold accumulators, index variables (`i`/`j`/`k` in short closures or index-based loops only), and test fixtures (identical roles only). Never use single letters in multi-line functions or closures
+- Prefer `where` clauses for multiple trait bounds
+- Derive order: std traits → comparison traits → `Hash` → derive_more → feature-gated
+- Custom errors: `#[derive(Debug, Display, Error)]` + `#[non_exhaustive]`
+- Minimize `unwrap()` in non-test code — use proper error handling
+- `#![deny(warnings)]` is active — code must be warning-free
+- Install toolchain before running tests: `rustup toolchain install "$(< rust-toolchain)" && rustup component add --toolchain "$(< rust-toolchain)" rustfmt clippy`
+- If the AI agent is Claude Code, `gh` (GitHub CLI) is not installed — do not attempt to use it
+- Run `FMT=true LINT=true BUILD=true TEST=true DOC=true ./test.sh` to validate changes

AGENTS.md

@@ -0,0 +1,19 @@
+# AI Instructions
+
+Read and follow the CONTRIBUTING.md file in this repository for all code style conventions, commit message format, and development guidelines.
+
+## Quick Reference
+
+- Commit format: Conventional Commits — `type(scope): lowercase description`
+- Version releases are the only exception: just the version number (e.g. `0.21.1`)
+- Prefer merged imports
+- Use descriptive generic names (`Size`, `Report`), not single letters
+- Use descriptive variable and closure parameter names by default — single letters are only allowed in: conventional names (`n` for count, `f` for formatter), comparison closures (`|a, b|`), trivial single-expression closures, fold accumulators, index variables (`i`/`j`/`k` in short closures or index-based loops only), and test fixtures (identical roles only). Never use single letters in multi-line functions or closures
+- Prefer `where` clauses for multiple trait bounds
+- Derive order: std traits → comparison traits → `Hash` → derive_more → feature-gated
+- Custom errors: `#[derive(Debug, Display, Error)]` + `#[non_exhaustive]`
+- Minimize `unwrap()` in non-test code — use proper error handling
+- `#![deny(warnings)]` is active — code must be warning-free
+- Install toolchain before running tests: `rustup toolchain install "$(< rust-toolchain)" && rustup component add --toolchain "$(< rust-toolchain)" rustfmt clippy`
+- If the AI agent is Claude Code, `gh` (GitHub CLI) is not installed — do not attempt to use it
+- Run `FMT=true LINT=true BUILD=true TEST=true DOC=true ./test.sh` to validate changes

CLAUDE.md

@@ -0,0 +1,19 @@
+# AI Instructions
+
+Read and follow the CONTRIBUTING.md file in this repository for all code style conventions, commit message format, and development guidelines.
+
+## Quick Reference
+
+- Commit format: Conventional Commits — `type(scope): lowercase description`
+- Version releases are the only exception: just the version number (e.g. `0.21.1`)
+- Prefer merged imports
+- Use descriptive generic names (`Size`, `Report`), not single letters
+- Use descriptive variable and closure parameter names by default — single letters are only allowed in: conventional names (`n` for count, `f` for formatter), comparison closures (`|a, b|`), trivial single-expression closures, fold accumulators, index variables (`i`/`j`/`k` in short closures or index-based loops only), and test fixtures (identical roles only). Never use single letters in multi-line functions or closures
+- Prefer `where` clauses for multiple trait bounds
+- Derive order: std traits → comparison traits → `Hash` → derive_more → feature-gated
+- Custom errors: `#[derive(Debug, Display, Error)]` + `#[non_exhaustive]`
+- Minimize `unwrap()` in non-test code — use proper error handling
+- `#![deny(warnings)]` is active — code must be warning-free
+- Install toolchain before running tests: `rustup toolchain install "$(< rust-toolchain)" && rustup component add --toolchain "$(< rust-toolchain)" rustfmt clippy`
+- If the AI agent is Claude Code, `gh` (GitHub CLI) is not installed — do not attempt to use it
+- Run `FMT=true LINT=true BUILD=true TEST=true DOC=true ./test.sh` to validate changes