Skip to main content
Refactron follows Semantic Versioning. The full, unabridged log lives in CHANGELOG.md.
​
0.2.4
June 17, 2026
Reliability and observability release. Five real fixes, one feature (tier taxonomy), one license change. No new transforms, no API breakage — every existing call site keeps working.Added
  • Tier taxonomy on every transform (debt / modernization / style). analyze output groups findings and remediation minutes by tier — the headline “N findings” splits into “57 debt, 102 modernization, 2,569 style” instead of one undifferentiated count.
  • byTier and minutesByTier fields in analyze --json output, with the invariant debt + modernization + style === totalMinutes.
  • BY TIER section in the boxed TUI analyze output.
Changed
  • License: MIT → Apache 2.0. Same permissive freedoms; adds an explicit patent grant from contributors. See LICENSE, NOTICE, and the FAQ.
Fixed
  • run --transforms=all silently dropped 8 transforms. The CLI’s local list had drifted out of sync with the engine’s canonical order when the v0.2.3 catalog expansion landed. CLI now imports TRANSFORM_ORDER directly; drift is pinned by a test. (#48, PR #49)
  • --files=<glob> was ignored on --apply. The glob only narrowed the dry-run preview; the apply path silently rewrote every matching finding. Filter is now applied to plan.changes before the split, so both paths honour it. (#50, PR #52)
  • Documenter broke files with multi-line return-type signatures. On def f() -> type[Union[…]]: shapes that span multiple lines, the inserter latched onto the first inner line of the type subscript as if it were the body. The walker now tracks bracket depth and skips inline Protocol stubs. (#51, PR #52)
  • apply and rollback dropped POSIX file modes. Both paths now round-trip mode bits.
  • class_to_dataclass injected imports before from __future__. New imports now land after the __future__ block, preserving PEP 236 ordering.
  • Silent refusals in four transform sidecars. pep585_generics, pep604_optional_union, datetime_utc_alias, callback_to_async_await now emit a precondition record on every refusal — no more “detected, but nothing changed” with no explanation.
  • manual_typecheck_to_hints was the silent sidecar Bug #3 missed. Every refusal path now records why; gating prevents noise from unrelated siblings; the nested-def scan stops at function boundaries. On Ansible: 16 silent files → 0; 4 records → 87 covering all 20 affected files. (#57, PR #58)
Known follow-ups
  • manual_typecheck_to_hints now records refusals but on Ansible still rewrites 0 of 20 files. Expanding the rewriter to handle docstring + body and dispatcher + fallthrough is tracked as #59.
  • Eight new transform candidates derived from a deeper Ansible scan are filed as #62–#69 for v0.3 / v0.4 prioritisation.
​
0.2.3
May 27, 2026
Ten new deterministic transforms — six for Python, four for TypeScript — roughly doubling Refactron’s transform coverage. Adds the pythonVersion config key so version-gated rewrites can be opted in safely.Added — Python
  • super_no_args — super(ClassName, self).method(...) → super().method(...). Refuses sibling/parent class names and nested-class shadows to preserve MRO.
  • lru_cache_to_cache — @functools.lru_cache(maxsize=None) → @functools.cache (≥ 3.9); also rewrites the from functools import … line.
  • pep585_generics — typing.List / Dict / Tuple / Iterable / … → list / dict / tuple / collections.abc.Iterable / … (≥ 3.9, or from __future__ import annotations). Refuses files with Pydantic v1 or get_type_hints to avoid runtime-eval crashes.
  • pep604_optional_union — Optional[X] → X | None; Union[A, B] → A | B (≥ 3.10, or from __future__ import annotations).
  • datetime_utc_alias — datetime.timezone.utc → datetime.UTC (≥ 3.11). No __future__ override — UTC is a runtime attribute.
  • yield_from_for_loop — for x in y: yield x → yield from y. Refuses inside async def (a CPython compile-stage SyntaxError LibCST’s parser does not catch).
Added — TypeScript
  • indexof_to_includes — arr.indexOf(x) !== -1 and friends → arr.includes(x). Type-aware via ts-morph (String / Array / ReadonlyArray receivers). Gated on tsconfig target ≥ ES2016.
  • object_assign_to_spread — Object.assign({}, a, b) → { ...a, ...b }. First arg must be an object literal; refuses spread-element sources. Gated on tsconfig target ≥ ES2018.
  • string_concat_to_template_literal — "…" + x + "…" → `…${x}…`. Refuses any / unknown / non-primitive operands. Gated on tsconfig target ≥ ES2015.
  • vue_set_delete_to_assignment — Vue.set / this.$set → direct assignment; Vue.delete / this.$delete → delete obj.k. .js / .ts only — .vue SFC parsing is deferred to v0.4. Refuses delete in expression context (return-value semantics differ). On Vue 2 codebases this is a semantic change (Vue.set is required for new reactive keys) — caveat ships in the suggestion text.
Added — Configuration
  • pythonVersion — pin the Python target version ("3.9", "3.11", …) for the four version-gated Python transforms. Auto-detected from pyproject.toml’s requires-python when unset; falls back to refusing version-gated transforms rather than guessing.
Changed
  • Engine composition — multi-transform composition is now order-stable: when several transforms touch the same file, each emits its own FileChange carrying the cumulative content, and the last one per path is what’s written to disk. Fixes a silent-data-loss bug where only the LAST transform’s rewrite survived under run --apply (PR #38).
​
0.2.2
May 18, 2026
Quality-of-life release for the analyze → run → document pipeline: boxed CLI output, a real rollback command, and a much more efficient document.Added
  • Bordered table output — analyze renders one box per file plus boxed TRANSFORMS / BY TRANSFORM / SUMMARY blocks; run --dry-run matches, with a CHANGES table and a four-sided diff box per file.
  • rollback command — undo an applied refactor or document run; journal-based LIFO undo, drift-safe, --all / --force / --dry-run.
  • run --apply live progress — gate-by-gate status and per-file verify/apply detail; batch-first with a per-file fallback when the batch fails.
  • run --apply short-circuit — exits early when no test runner is detected, instead of silently skipping the test gate.
  • Full report saved to disk — analyze / run --dry-run write the complete report to .refactron/reports/.
  • document enrichments — inline comments, a per-run modernization report under docs/refactron/, and a post-apply syntax re-check.
Changed
  • document is far more efficient — docstring requests are batched with bounded concurrency and token-aware rate limiting; the LLM call count is now O(source tokens / batch budget), not O(symbols).
Fixed
  • document produced zero docstrings on large files — batches were sized by input tokens only, so the combined response overran the completion cap and truncated. Batches are now also capped by response size, and a truncated reply is salvaged entry-by-entry.
  • document six-quote docstring bug (""""""…""""""); rate-limited runs that ground on for minutes; report / CHANGELOG paths normalized to forward slashes on Windows.
  • analyze — old-string-format findings now anchor on the operator, not the opening quote; manual_typecheck_to_hints no longer flags already-annotated parameters; the misleading “Fixable N/N” became an honest auto-fix-candidate count.
  • deprecated_api_requests_to_httpx no longer emits runtime-broken code — it refuses files using requests API that is not a safe httpx drop-in.
​
0.2.1
May 16, 2026
Patch release — a large-file crash fix and two transform-coverage improvements.Fixed
  • analyze crashed on files larger than ~32 KB — tree-sitter’s native binding rejects oversized string input. Parsing now uses the streaming callback-input form; a single unparseable file is skipped rather than aborting the run.
  • var_to_const_let dropped whole files — reassignment checks matched identifiers by text across the entire file. Reference resolution is now scope-correct, and for-loop var i initializers are covered.
Changed
  • format_to_fstring now converts the full printf grammar — %d, %.2f, %x, %o, %e, %g, width/precision specifiers, and %%. Mapping %(name)s, non-literal targets, and dynamic * widths are still conservatively skipped.
​
0.2.0
May 15, 2026
First public release of the v2.0 deterministic-refactoring rebuild.Added
  • Engine — 10 deterministic AST transforms (5 Python via LibCST, 5 TypeScript via ts-morph) with cross-file preconditions.
  • 3-gate verification — syntax + imports + tests on a shadow tree, with atomic batch write or rollback.
  • Documentation engine — the only LLM-touching component, running only on already-verified diffs; 5 providers (Ollama, Groq, OpenAI, Anthropic, managed backend).
  • .refactronrc.json config — cosmiconfig + Ajv schema validation.
  • Authentication — OAuth device flow with REFACTRON_TOKEN support and long-lived API keys.
  • A Mintlify documentation site and reproducible performance benchmarks under bench/.