Files
Brandon Greenwell 32e58c4ffc Clean up repo and refresh documentation
- Remove the stale analysis report from the repo (an old planning file
  and local HTML renders were also deleted, untracked)
- Commit the validation scripts and hand-verified golden baselines so
  contributors and CI can run the same checks; tighten their README
- Slim the crates.io package (60 -> 21 files) by excluding examples,
  assets, CI config, and development scripts/docs
- Document sort-flag precedence in help text and README:
  --dotfiles-first implies --dirs-first (verified identical output),
  --natural-sort takes precedence over --case-sensitive; simplify the
  README example that passed both redundantly
- Refresh the README feature list to cover search, mouse support,
  editor resume, --du, display limits, and JSON output; fix the broken
  License link and a stray code-fence typo
- Add AGENTS.md recording architecture, DFS-order invariants, and
  testing conventions (pty/expect requirements, Windows filename rules)
2026-07-11 23:00:18 -04:00
..

Baseline outputs

Hand-verified reference outputs for examples/sample-directory, checked by scripts/validate-basic.sh. Any diff against these files is a regression unless the behavior change is intentional.

File Command
basic-tree.txt cargo run examples/sample-directory
depth-2.txt cargo run examples/sample-directory -L 2
depth-2-with-flags.txt cargo run examples/sample-directory -G -p -L 2
depth-2-dirs-first.txt cargo run examples/sample-directory --dirs-first -L 2
depth-2-natural-sort.txt cargo run examples/sample-directory --natural-sort -L 2

Connector rules the baselines encode: ├── for an entry with a following sibling, └── for the last sibling, │ continuing an ancestor that has more siblings below.

To update a baseline after an intentional change: regenerate it with the command above, review the diff by eye, and note the change in CHANGELOG.md. Baselines are generated on Unix; the permissions column (-p) renders as placeholders on Windows.