May 18, 2026 · v0.2.2

Boxed Output, Rollback & a Faster Docs Engine

Journalled rollback, boxed reports, live apply progress, and a faster documentation engine.

Major features

  • rollback. Undo an applied refactor or documentation run: a journalled, drift-safe LIFO undo with --all, --force, and --dry-run.
  • Boxed output. analyze and run --dry-run render bordered tables, one box per file, plus transform and summary blocks.
  • run --apply live progress. Gate-by-gate status, with a per-file verify and apply fallback when a batch fails.
  • Reports on disk. analyze and run --dry-run write the full report to .refactron/reports/ so long output survives terminal scrollback.
  • Richer document. document now also writes inline comments, a per-run modernization report, and runs a post-apply syntax re-check.

Improvements

  • Faster document. Docstring requests are batched with bounded concurrency and token-aware pacing: call count scales with source size, not symbol count.

Bug fixes

  • Large-file docs. document no longer drops every docstring on big files: batches are capped by response size and truncated replies are salvaged.
  • Transform safety. deprecated_api_requests_to_httpx refuses files using non-drop-in requests API instead of emitting runtime-broken code.
  • analyze accuracy. Old-string-format findings anchor on the operator; manual_typecheck_to_hints no longer flags already-annotated parameters.
  • Cross-platform. Report and CHANGELOG paths are normalized to forward slashes on Windows.