chore(release): v0.2.4

[omsherikar]

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.

Pre-publish chain

• npm run typecheck — clean
• npm run lint --max-warnings 0 — clean
• npm run format:check — clean
• npm run build — succeeds
• npm test — 742 / 742 passing
• npm publish --dry-run — tarball 377.7 kB, no leaks (no dev-docs/, no playground/, no tests/, no fixtures/)
• node dist/cli/index.js --version → 0.2.4

Added

• Tier taxonomy on every transform (debt / modernization / style) — analyze groups findings + minutes by tier
• byTier / minutesByTier in analyze --json (invariant: debt + modernization + style === totalMinutes)
• BY TIER section in the boxed TUI output

Changed

• License: MIT → Apache 2.0. Same permissive freedoms; adds an explicit patent grant from contributors

Fixed

#	Bug	PR
#48	run --transforms=all silently dropped 8 transforms	#49
#50	--files=<glob> ignored on --apply	#52
#51	Documenter broke files with multi-line return-type signatures	#52
—	apply / rollback dropped POSIX file modes	inline
—	class_to_dataclass injected imports before from __future__	inline
—	Silent refusals in 4 sidecars (pep585, pep604, datetime_utc, callback_to_async)	186d714
#57	manual_typecheck_to_hints was the silent sidecar Bug #3 missed	#58

Internal

• .claude/ ops scaffolding (10 senior subagents, 3 slash commands, 3 hooks, CODEOWNERS, ARCHITECTURE/GLOSSARY/RUNBOOK + style rules + templates) — PR chore(ops): scaffold senior-team operations layout #60
• README rewrite + animated banner + docs/reference/performance.mdx + docs/reference/citations.mdx — PR chore(license): relicense MIT to Apache-2.0 + rewrite README #61

Files in this PR

• CHANGELOG.md — new [0.2.4] section
• package.json — version 0.2.3 → 0.2.4
• README.md — install command pinned to 0.2.4
• docs/changelog.mdx — new <Update> block
• docs/overview.mdx, docs/quickstart.mdx — install command + version-check output bumped

Known follow-ups (NOT blocking)

• manual_typecheck_to_hints now records why it refuses but still rewrites 0 of 20 Ansible files. Expanding the rewriter to handle docstring + dispatcher and dispatcher + fallthrough shapes is feat(transform): expand manual_typecheck_to_hints to handle docstring + fallthrough patterns #59, deferred.
• Eight new transform candidates surfaced by a deeper Ansible scan are filed as feat(transform): type_comment_to_annotation — promote PEP 484 type comments to PEP 526 native annotations (~78 Ansible sites) #62–feat(transform): typealias_to_pep695 — X: TypeAlias = ... → type X = ... statement (Py 3.12+) #69 for v0.3 / v0.4 prioritisation.

After merge

The npm publish step is a manual operation per RUNBOOK.md — the project's safety hook blocks Claude from running it. Tag v0.2.4, push tags, npm publish, then draft the GitHub Release.

Summary by CodeRabbit

• New Features

  • Added tier taxonomy to analyze output with new byTier/minutesByTier JSON fields and TUI section.

• Bug Fixes

  • Fixed --transforms=all dropping transforms.
  • Fixed --files flag being ignored during apply.
  • Fixed multi-line return-type signature parsing.
  • Fixed POSIX file mode preservation on apply/rollback.
  • Fixed import ordering relative to from __future__.

• Chores

  • License updated from MIT to Apache 2.0.

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: 18740e7c-a922-4ca3-8857-63188b7b1530

📥 Commits

Reviewing files that changed from the base of the PR and between 1d512d4 and c3a1c05.

📒 Files selected for processing (6)

• CHANGELOG.md
• README.md
• docs/changelog.mdx
• docs/overview.mdx
• docs/quickstart.mdx
• package.json

---

📝 Walkthrough

Walkthrough

Version bumped from 0.2.3 to 0.2.4 in package.json, README.md, and all documentation files. A new 0.2.4 release entry is added to CHANGELOG.md and docs/changelog.mdx covering tier taxonomy output fields, an MIT-to-Apache-2.0 license change, and several reliability fixes. Historical changelog section formatting is also corrected.

Changes

v0.2.4 Release Documentation

Layer / File(s)	Summary
New 0.2.4 release notes content CHANGELOG.md, docs/changelog.mdx	Adds the full 0.2.4 release section (tier taxonomy on analyze, Apache 2.0 license, reliability/import/POSIX-mode fixes, sidecar precondition recording, known follow-ups) to both the root changelog and the docs MDX changelog, with existing 0.2.3–0.2.0 entries repositioned below the new entry.
Version bump in package manifest and docs package.json, README.md, docs/overview.mdx, docs/quickstart.mdx	Bumps version in package.json to 0.2.4 and updates every install-command example and the refactron --version expected-output snippet across README and docs; also reformats the quickstart <img> block and rollback note text.
Historical CHANGELOG.md section formatting fixes CHANGELOG.md	Corrects ### Changed vs ### Fixed subsection placement and adds blank-line spacing for 0.2.2, 0.2.1, 0.2.0, 0.1.0-beta.2, and 0.1.0-beta.1 entries.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 Hop, hop, the version leaps ahead,
From .3 to .4 the changelog said!
Tier taxonomy blooms, Apache takes reign,
POSIX modes preserved through apply's refrain.
A bunny stamps 0.2.4 with glee —
The docs are fresh, come install and see! 🥕

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
refactron	🟢 Ready	View Preview	Jun 17, 2026, 6:42 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.