Skip to content

feat: read-only extraction previews and reliable file selection - #51

Merged
cortega26 merged 2 commits into
mainfrom
feat/extraction-preview-20261012
Oct 12, 2026
Merged

cortega26 merged 2 commits into
mainfrom
feat/extraction-preview-20261012

Conversation

@cortega26

Copy link
Copy Markdown
Owner

Why

A useful extraction tool should let users inspect a selection before processing and should apply the same rules to every file.

Implemented

  • Add --dry-run / --preview-format json with no output or report writes.
  • Report selected files, source-relative paths, byte sizes, and destination-overwrite warnings.
  • Reuse the existing processor's file selector rather than maintain separate preview rules.
  • Make traversal deterministic, keep README/SPECIFICATIONS priority only if eligible, and exclude symlinked files that may escape the tree.
  • Add regression tests and CLI documentation.
  • Add a minimal GitHub Actions pytest/coverage workflow to give this repository operational CI feedback.

Scope boundaries

  • This first increment does not implement token counting, .gitignore handling, or secret scanning. It does not change the GUI.
  • Preview file sizes are not a guarantee of successful UTF-8 decoding.

Validation

  • Static review of main@ab43af99fb0bcba472c4da6511332b552abc1f75 and existing tests.
  • New tests are included; GitHub Actions on this PR will establish runtime results.

Next

If the tests pass, investigate safe atomic output and Git-aware filtering as a separate improvement.

@cortega26
cortega26 merged commit c0e8199 into main Oct 12, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant