Skip to content

Release Notes

All Rad releases. Newest first.

v0.9.0 - 2026-03-11

v0.9 is here!

Please note this version contains a higher number of breaking changes than usual.

I am trying to get them out of the way sooner rather than later, to minimize the overall pain.

I've done my best to make migrating really clear, including having error detection and clear messages that try and detect when you're doing something "the old ways".

See https://amterp.github.io/rad/migrations/v0.9/ for details about the breaking changes.

  • feat!: broaden ?? to null-coalesce, catchable null indexing (4fa150c)
  • feat!: make + operator strict about type matching (1ec9e5c)
  • feat!: shorten parse_epoch unit parameter names (2a09c43)
  • feat!: stop normalizing user data, add split_lines() (14a4b2c)
  • feat!: unify request/display into single rad keyword (3d09b27)
  • feat(funcs): make numeric functions type-preserving (18209b7)
  • feat: accept Enter as confirmation in confirm() (52655ab)
  • feat: add "did you mean?" suggestions for undefined vars (2a09807)
  • feat: add 'rad explain list' to show available error codes (4b6b4c4)
  • feat: add --ast-tree and --cst-tree debug flags (f3c3ba8)
  • feat: add CST-to-AST converter (ec3185e)
  • feat: add Rust-style diagnostic renderer (e2e06d4)
  • feat: add TLS certificate verification bypass (322e9a2)
  • feat: add call stack tracking and stack traces (338ffe3)
  • feat: add catch inline operator for error-only catching (a7878a4)
  • feat: add error testing framework and documentation (5f4ee17)
  • feat: add fill character and zero-pad to format specs (5d5a851)
  • feat: add heuristics for ERROR node detection (9b4d2e8)
  • feat: add index_of() built-in for strings and lists (b33748f)
  • feat: add inline migration hint for + operator type error (7372764)
  • feat: add limit param to split() (539e566)
  • feat: add parse_duration and convert_duration functions (cef9648)
  • feat: add rad explain command for error documentation (2f599d6)
  • feat: add semantic grammar checks for control flow (790c615)
  • feat: add source span tracking to RadValue (f71e0dd)
  • feat: add symbol table for tracking variable definitions (95ce0ff)
  • feat: add trim_left and trim_right functions (a7225df)
  • feat: add unified diagnostic type system (7458ca7)
  • feat: define AST node types, interfaces, and enums (c518d3e)
  • feat: enable invocation logging by default (b7b95e2)
  • feat: expand MISSING node messages with parent context (930212f)
  • feat: extract shared duration parser with day support (76983e2)
  • feat: render markdown error docs with terminal styling (15e4995)
  • feat: show [command] instead of [subcommand] in help (8861a11)
  • feat: show per-severity diagnostic counts in check --from-logs (c412221)
  • fix!: align trim_prefix/trim_suffix semantics with their names (0f02eb1)
  • fix(deps): resolve Dependabot security alerts (4c19a81)
  • fix: AST dump span padding now walks full tree (3f514c9)
  • fix: Levenshtein distance operates on bytes instead of runes (e6ac0a1)
  • fix: TruthyFalsy crashes on RadError values (6837175)
  • fix: add missing error codes to validation errors (bb9637d)
  • fix: bugs found in code review of AST foundation (3c4e5ad)
  • fix: bump ra to v0.5.1 (1a97b79)
  • fix: clone target node in compound assign/incr-decr desugaring (12c49b6)
  • fix: derive gutter width from displayed lines, not labels (21c218a)
  • fix: diagnostic panics and lambda file name (b245ca0)
  • fix: diagnostic renderer byte-slices UTF-8 in truncation (ea38df9)
  • fix: flaky truncate tests due to shared TerminalIsUtf8 state (d7e964a)
  • fix: include response headers in http_* return value (902e00f)
  • fix: minor comment adjustments (3870211)
  • fix: nil node panic in error emission functions (d81c49a)
  • fix: nil node safety and same-line label coloring (8f2dac0)
  • fix: panic on short non-JSON response body in RequestJson (f3d2a4c)
  • fix: preserve text attributes in trim, reverse, slice (39bed25)
  • fix: prevent hang on non-regular files like /dev/stdin (66dcf7b)
  • fix: release notes workflow inserting into front matter (6093f5f)
  • fix: remove invalid --latest flag from gh release view (84382dc)
  • fix: shell catch nil pointer dereference (abce025)
  • fix: split_lines strips trailing empty element (9f3dbb2)
  • fix: string slicing now correctly handles multi-byte characters (a0af29c)
  • fix: truncate() now handles multi-byte characters correctly (f62848d)
  • fix: unify equality semantics across == and Equals() (27dc974)
  • fix: update go mod, add more details to AGENTS.md re: migrations (da5efea)
  • fix: use pure Go DNS resolver for Linux static builds (622026c)
  • perf: fix IndexAt() to extract runes from segment directly (d082015)
  • perf: fix ToRuneList() O(n^2) complexity (5fbaed2)
  • perf: short-circuit Plain() for single-segment strings (ea6c560)
  • perf: use strings.Builder in Plain() and Reverse() (273beb2)
  • refactor: clarify diagnostic type hierarchy (3136be7)
  • refactor: complete AST migration phases 5-8 (a258ce7)
  • refactor: migrate all errorf calls to new diagnostic system (a0a26f3)
  • refactor: migrate checker from CST to AST (14c797d)
  • refactor: migrate checker to AST, remove dead code (9fcb675)
  • refactor: migrate interpreter from CST to AST (31eb894)
  • refactor: migrate metadata extraction to AST (531a112)
  • refactor: move Span type from core/ to rts/rl/ (47acb87)
  • refactor: remove dead code from interpreter (7f93506)
  • refactor: remove unused SymbolTable, keep Levenshtein (de5cdc7)
  • refactor: seal CST from core/, add Children() to AST (2d3b92d)
  • refactor: seal CST leaks from public interfaces (0dc6c61)
  • refactor: simplify evalCatchingPanic, document error contract (9ddc1bb)
  • refactor: unify dump tests into Go-based CST snapshot system (7658ed3)
  • refactor: unify error output to Rust-style format (ccb3bec)
  • refactor: wire LSP to use AST-aware checker (b820903)
  • rename get_stash_dir to get_stash_path (b8ed277)
  • revert: remove RadValue span tracking (perf fix) (162eb5a)
  • style: minor adjustments (83a7ac9)
  • style: reformat (5328143)
  • tests: improve snapshot failure diff output (9f0e414)
  • tests: migrate common input->output assert tests to snapshot tests (9d57d24)

v0.8.1 - 2026-03-08

  • fix: use pure Go DNS resolver for Linux static builds (622026ca)

v0.8.0 - 2026-01-29

  • feat!: remove get_default function in favor of ?? operator (7bbad61)
  • feat(docs): redesign website with "Sunset Terminal" theme (79b0103)
  • feat: add ?? fallback support for list and string indexing (7350604)
  • feat: add list support to reverse function (d13e6d7)
  • feat: hyphenate command names for CLI invocation (c8373a2)
  • fix: use workflow_run trigger for release notes workflow (7c450bf)

v0.7.1 - 2026-01-26

  • Release VSCode extension v0.3.0 (9443d85)
  • ci: add automated docs deployment and release notes (883a593)
  • ci: add cross-platform testing for macOS and Windows (e085011)
  • ci: fix Windows build output filename in cross-platform tests (4474ee3)
  • ci: treat all platforms as equal first-class citizens (668a509)
  • feat: add platform abstraction for Windows compatibility (5fdf8fd)
  • feat: add underscore to v0.7 for-loop migration hint detection (cf4af1a)
  • feat: complete platform normalization for Windows compatibility (83c839e)
  • fix: improve gen_fid collision resistance (0ee37ff)

v0.7.0 - 2026-01-16

  • docs(SYNTAX.md): add script commands (9e4e595)
  • feat!: redesign for-loop syntax with explicit context access (e98f7fc)
  • See v0.7 migration guide for more information.
  • feat: add context support to rad block map/filter lambdas (21976ec)

v0.6.27 - 2026-01-11

  • Release VSCode extension v0.2.0 (80c4102)
  • fix: multiline string interpolation followed by content (5365366)

v0.6.26 - 2026-01-02

  • ci: optimize ci benchmarks by interleaving & reducing runs (3a4a7f4)
  • feat(pick): implement 'prefer_exact' named arg (a3092c7)
  • feat: improve syntax error messages with specific diagnostics (82d9472)
  • feat: unpackage radls from vs code extension, use PATH instead (d79186f)

v0.6.25 - 2025-12-16

  • Release VSCode extension v0.1.13 (c492a49)
  • docs(thinking): Rewrite imports.md and add some quick counter thoughts (f50a960)
  • feat: add additional get_path fields e.g. modified_millis (f536f12)
  • feat: allow parse_epoch to accept floats (c15def5)
  • fix: avoid Go 'MISSING' formatting malformed print in shell cmds (6a69141)

v0.6.24 - 2025-12-14

  • feat: add flat_map function (0f72798)

v0.6.23 - 2025-12-10

  • feat: allow min/max to accept var args of numbers (fb6582d)

v0.6.21 - 2025-12-03

v0.6.20 - 2025-12-03

  • ci: attempt brew CI fix by pulling latest commit (775afad)

v0.6.19 - 2025-12-02

  • ci: attempt to fix homebrew release (da006f4)

v0.6.18 - 2025-11-29

  • feat: implement 'filter' rad block field modifier syntax (022267b)
  • fix: un-indent command descriptions (5f1480e)

v0.6.17 - 2025-11-20

  • Release VSCode extension v0.1.12 (d70dbbe)
  • feat(checker): add warning against undefined cmd callback references (868d6f8)
  • feat: add function 'multipick' (8c96666)
  • fix: delete pointless multipick tests (6a0ebba)

v0.6.16 - 2025-11-19

  • Implement commands in Rad (cef9661)

v0.6.15 - 2025-11-09

  • Release VSCode extension v0.1.11 (1c6bb65)
  • feat: recognize hoisted functions for unknown functions check (e535795)
  • fix: allow --version --src and --src-tree on invalid scripts (4220c18)
  • fix: avoid passing arg-less prints through printf (7e16b1a)
  • fix: fix x/crypto dependency (5bb2ea7)

v0.6.14 - 2025-11-04

  • feat(check): add error check against hoisted functions shadowing args (ff839e6)
  • feat: allow non-str types in colorize function (ba71c19)

v0.6.13 - 2025-11-03

  • Release VSCode extension v0.1.10 (e27b21c)
  • ci: fix test-runner.rad syntax (18c9bad)
  • docs(guide): add complete example to getting started (c4df48a)
  • docs(guide): add error-handling.md (4a7f9f5)
  • docs(guide): add type-annotations.md (20fe398)
  • docs(guide): shorten shell-commands.md header (d704c25)
  • docs(guide): update args.md (ab615c6)
  • docs(guide): update basics.md (0a38d12)
  • docs(guide): update functions.md (67b5fdc)
  • docs(guide): update getting started (7974f4c)
  • docs(guide): update rad-blocks.md (5c58d83)
  • docs(guide): update shell-commands.md (863c3c1)
  • docs(guide): update strings-advanced.md (2776ef6)
  • feat: revamp http url encoding behavior (d91350b)
  • fix(fomatting): accept thousands_separator before alignment/padding (c18c971)
  • fix(shell): fix shell modifier keywords (e448f72)
  • fix: check built-in function signatures for parsing errors (17b14fe)
  • fix: use Print, not Printf for --src (8579dac)
  • tests: fix broken tests from earlier commit (0dba710)

v0.6.12 - 2025-10-16

Breaking!

This release changes shell and error handling syntax, expect breaks.

// OLD: Critical command
$!`make build`

// NEW: Same behavior (critical by default)
$`make build`

// OLD: Unsafe command
unsafe $`command_that_might_fail`

// NEW: Use catch block
$`command_that_might_fail` catch:
    pass

// OLD: Recover block
$`curl {url}`
recover:
    print_err("Failed but continuing")

// NEW: Use catch block
$`curl {url}` catch:
    print_err("Failed but continuing")

// OLD: Fail block
$`curl {url}`
fail:
    print_err("Failed, exiting")
    exit(1)

// NEW: Use catch block with exit
$`curl {url}` catch:
    print_err("Failed, exiting")
    exit(1)
  • Release VSCode extension v0.1.9 (46e3eed)
  • feat: implement new error handling syntax (catch suffix) (5c0253c)
  • feat: implement new shell syntax + catch suffix syntax (7ef3f46)
  • feat: update syntax dump tests for new shell & error handling syntax (78a4857)
  • feat: update textmate grammar for new shell + error handling syntax (981fdfb)

v0.6.11 - 2025-10-12

  • feat: add --from-logs flag to check cmd (468b455)
  • feat: add global config loading (a068c49)
  • feat: add invocation logging & rolling (c5ee8e7)
  • refactor: move Run up in runner.go (2257aa7)

v0.6.10 - 2025-10-06

  • Release VSCode extension v0.1.8 (5b94a4e)
  • feat: add stdin support for Unix-style piping (cd880f7)

v0.6.9 - 2025-10-05

  • feat: allow scientific notation for int defaults (8fd724a)
  • feat: validate script immediately after parsing (127f484)
  • fix: correctly allow unknown flags to be absorbed in var args (34ee9be)
  • fix: resolve shell command pipe race condition (319a956)

v0.6.8 - 2025-09-30

  • Release VSCode extension v0.1.7 (4b6613e)
  • ci: implement 5 more PR benchmarks (f8310f0)
  • feat: allow int short count arg input style (05b7ee2)

v0.6.7 - 2025-09-28

  • Bump version to v0.6.7 (379d785)
  • ci: add PR benchmarking (046a3c2)
  • ci: add PR check automation (9efd9b4)
  • ci: add benchmark-scripts (7f6349c)
  • feat: support formatting numbers with commas separating thousands (9e2bc45)
  • tests: fix local TZ-dependent time tests (8e2dd59)

v0.6.6 - 2025-09-27

v0.6.5 - 2025-09-27

v0.6.2 - 2025-09-21

v0.6.1 - 2025-09-21

v0.6.0 - 2025-09-21

  • fix: returning from fn in for loop by @amterp in https://github.com/amterp/rad/pull/44
  • feat(args): support var args by @amterp in https://github.com/amterp/rad/pull/45

v0.5.59 - 2025-09-14

  • Replace pflag with Ra by @amterp in https://github.com/amterp/rad/pull/38
  • feat: add function 'matches' for regex matching by @amterp in https://github.com/amterp/rad/pull/39
  • fix: convert arg constraint targets to external name format by @amterp in https://github.com/amterp/rad/pull/40
  • feat: add global flag '--rad-args-dump' by @amterp in https://github.com/amterp/rad/pull/41
  • feat(repl): implement REPL by @amterp in https://github.com/amterp/rad/pull/43

Historical Releases

Releases before automated GitHub releases. Notable changes only.

v0.5 - 2025-02-12

  • Replaced handwritten lexer/parser with tree sitter
  • defer statements
  • Further shell command support improvements, critical shell commands
  • Emoji support
  • Basic syntax highlighter
  • Reworked JSON field extraction algo
  • errdefer
  • Reworked string character escaping
  • Improved rad block sorting operation, added matching sort function
  • Added more functions: confirm, range, split etc
  • Removed Cobra
  • Reworked strings (RslString, attributes, colors)
  • http functions
  • parsing functions e.g. parse_int, parse_float
  • .dot.syntax for map key access
  • Truthy/falsy logic
  • Raw strings
  • Multiline strings
  • Arg constraints - enum, regex
  • Modulo operator %
  • ++/-- operators

v0.4 - 2024-10-28

  • exit function
  • Allow output pass-through in rad blocks
  • rad field modifiers: truncate, color
  • Reworked arrays: all arrays now allow mixed types
  • maps
  • collection entry assignment
  • del
  • in and not in
  • Json algo: allow capturing json nodes as maps
  • Added list/string slicing
  • Improved indexing, including negative indexing
  • Added ternary expressions
  • Added inline expressions for string interpolation, including formatting
  • Implemented shell command invocation

v0.3 - 2024-09-29

  • Improved shell embedding
  • Improved table-to-terminal size adjustment
  • Good unit testing
  • Compound assignments
  • Allow mocking responses --MOCK-RESPONSE
  • Json algo: add * wildcard capture
  • rad sort statements
  • Colorized headers
  • Switch from int to int64 representation of ints
  • Add pick functions, including pick_from_resource
  • Add list comprehensions
  • request and display blocks

v0.2 - 2024-09-09

  • Added Apache License 2.0
  • Arg defaults
  • std functions: date functions, replace, join, upper/lower, etc
  • 'Single quote' strings

v0.1 - 2024-09-08

  • Initial version
  • Newest notable feature was --STDIN and output shell export commands.